@hestia-earth/data-validation 0.41.7 → 0.41.9

package/file-errors/public-api.js

@@ -202,6 +202,11 @@ var validations = [
     level: "error",
     message: "longFallowDuration must be lower than 5 years"
   },
+  {
+    function: "validate_plantationLifespan",
+    level: "error",
+    message: "must be greater than or equal to plantationProductiveLifespan"
+  },
   {
     function: "validate_waterRegime_rice_products",
     level: "error",
@@ -427,6 +432,11 @@ var validations = [
     level: "warning",
     message: "should specify the fate of cropResidue"
   },
+  {
+    function: "validate_cycleDuration",
+    level: "error",
+    message: "must be one year prior to endDate"
+  },
   {
     function: "validate_cycleDuration",
     level: "error",
@@ -627,6 +637,11 @@ var validations = [
     level: "error",
     message: "must specify is it an animal feed"
   },
+  {
+    function: "validate_isAnimalFeed_animal_cycle",
+    level: "error",
+    message: "isAnimalFeed not allowed on a non-animal cycle"
+  },
   {
     function: "validate_saplings",
     level: "error",
@@ -637,6 +652,11 @@ var validations = [
     level: "error",
     message: "seed cannot be used as an input here"
   },
+  {
+    function: "validate_saplings_depreciated",
+    level: "error",
+    message: "saplingsDepreciatedAmountPerCycle cannot be used as an input here"
+  },
   {
     function: "validate_material_depreciated",
     level: "error",
@@ -647,6 +667,11 @@ var validations = [
     level: "error",
     message: "must be a product"
   },
+  {
+    function: "validate_input_unspecified_term",
+    level: "warning",
+    message: "should use a specific term"
+  },
   {
     function: "_validate_all_values",
     level: "warning",
@@ -682,6 +707,11 @@ var validations = [
     level: "error",
     message: "must not be blank if complete"
   },
+  {
+    function: "validate_completeness_transport",
+    level: "error",
+    message: "must have a value or a distance if complete"
+  },
   {
     function: "validate_has_termType",
     level: "warning",
@@ -751,6 +781,11 @@ var validations = [
     function: "validate_excreta_inputs_products",
     level: "error",
     message: "must be included as an Input"
+  },
+  {
+    function: "validate_transformation_inputs_value",
+    level: "error",
+    message: "must be specified for multiple Inputs with the same term"
   }
 ];
 
@@ -1130,6 +1165,20 @@ var guidePageId = (nodeType2, errorMessage) => {
 var mapErrorMessage = "does not contain latitude and longitude";
 var allowedDataPathsLabels = Object.values(schema.SchemaType);
 var isInfrastructureInputTermType = (dataPath = "") => /infrastructure\[\d+\]\.inputs\[\d+\]\.term\.termType$/.test(dataPath);
+var termTypeRestrictingFields = {
+  [schema.SchemaType.Practice]: {
+    variety: [schema.TermTermType.landCover],
+    ownershipStatus: [schema.TermTermType.operation]
+  }
+};
+var isNodeTermTypeRule = (schemaPath = "") => /^#\/allOf\/\d+\/then\/properties\/term\/properties\/termType\/enum$/.test(schemaPath);
+var sameValues = (values = [], others = []) => values.length === others.length && values.every((value) => others.includes(value));
+var termTypeRestrictingField = (nodeType2, schemaPath, allowedValues) => {
+  var _a;
+  return isNodeTermTypeRule(schemaPath) ? (_a = Object.entries(termTypeRestrictingFields[nodeType2] || {}).find(
+    ([, termTypes]) => sameValues(termTypes, allowedValues)
+  )) == null ? void 0 : _a[0] : void 0;
+};
 var idPatternError = (chars) => `You can only use the following characters for this field: ${chars.join(", ")}`;
 var noTillage = { id: "noTillage", name: "No tillage" };
 var pastureGrass = { id: "pastureGrass", name: "Pasture grass" };
@@ -1342,9 +1391,11 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     ${errorCount === 1 ? "Please check the measurement, its depth intervals, and the dates of the measurement or update the soil texture if needed." : "Please check your measurements, their depth intervals, and the dates of the measurements or update the soil textures if needed."}`;
     },
     "should be equal to one of the allowed values": ({ params, dataPath, schemaPath }, count, errors) => {
-      var _a;
+      var _a, _b;
       const paths = parseDataPath(dataPath);
-      const values = paths.length >= 2 ? pluralize(paths[paths.length - 1].path, ((_a = params == null ? void 0 : params.allowedValues) == null ? void 0 : _a.length) || 0) : "values";
+      const nodeLabel = (_a = paths[paths.length - 3]) == null ? void 0 : _a.label;
+      const restrictingField = dataPath.endsWith("term.termType") ? termTypeRestrictingField(nodeLabel, schemaPath, params == null ? void 0 : params.allowedValues) : null;
+      const values = paths.length >= 2 ? pluralize(paths[paths.length - 1].path, ((_b = params == null ? void 0 : params.allowedValues) == null ? void 0 : _b.length) || 0) : "values";
       const schemaPathMatch = schemaPath == null ? void 0 : schemaPath.split("/").slice(0, 3).join("/");
       const ifError = schemaPathMatch ? errors.find(
         (error) => {
@@ -1359,7 +1410,11 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
       return [
         isInfrastructureInputTermType(dataPath) ? `Only terms in the ${listAsCodeWithAnd(params == null ? void 0 : params.allowedValues)} glossaries can be added as inputs to Site
         infrastructure. Other inputs, e.g., ${code("fuel")}, should be specified on the Cycle.
-        You can use the ${schemaLink("Input#operation", "operation")} field on inputs to specify what the input is for.` : dataPath.endsWith("term.termType") ? [
+        You can use the ${schemaLink("Input#operation", "operation")} field on inputs to specify what the input is for.` : restrictingField ? `The ${schemaLink(`${nodeLabel}#${restrictingField}`, restrictingField)} field can only be added to ${pluralize(
+          nodeLabel,
+          0
+        )} using a term from the following glossaries: ${listAsCode(params == null ? void 0 : params.allowedValues)}.
+        Please either remove ${code(restrictingField)} from this ${nodeLabel}, or change the Term to one from the glossaries listed above.` : dataPath.endsWith("term.termType") ? [
           `For ${pluralize(
             paths[paths.length - 3].label,
             0
@@ -1391,6 +1446,10 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     "longFallowDuration must be lower than 5 years": () => `Your long fallow duration is greater than five years.
     Fallow is defined by FAOSTAT as land left uncultivated for between 1 and 5 years,
     and this definition is used for HESTIA also.`,
+    "must be greater than or equal to plantationProductiveLifespan": ({ params }) => `The ${termLink({ id: "plantationLifespan", name: "Plantation lifespan" })} (${code(params == null ? void 0 : params.current)} days)
+    is shorter than the ${termLink({ id: "plantationProductiveLifespan", name: "Plantation productive lifespan" })}
+    (${code(params == null ? void 0 : params.min)} days).
+    The productive lifespan is part of the plantation lifespan, so it cannot be longer. Please check both values.`,
     "should be more than the cropping duration": ({ params }) => `The ${schemaLink(
       "Cycle#cycleDuration",
       "cycleDuration"
@@ -1432,6 +1491,13 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     },
     "must be equal to previous product multiplied by the share": () => `Products from a transformation which are an Input in to the next transformation must follow the following rule:
     ${code("previous.product.value * current.transformedShare / 100 == current.input.value")}`,
+    "must be specified for multiple Inputs with the same term": ({ params }) => {
+      var _a, _b;
+      return `There are multiple Inputs of ${code(((_a = params == null ? void 0 : params.term) == null ? void 0 : _a.name) || ((_b = params == null ? void 0 : params.term) == null ? void 0 : _b["@id"]))} in this Transformation
+    which only differ by fields other than ${code("variety")} or ${code("fate")}, so the ${code("transformedShare")}
+    cannot tell how the Product ${code("value")} should be split between them.
+    Please specify the ${code("value")} of each of these Inputs.`;
+    },
     "at least one Input must be a Product of the Cycle": () => `A Transformation converts a Product from a Cycle into another Product.
     Therefore, at least one Input into the Transformation must be a Product of the Cycle.`,
     "must have only one entry with the same term.termType = excretaManagement": () => `There can only be one Practice of type excretaManagement in a Cycle.
@@ -1479,6 +1545,15 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
         (_d = params == null ? void 0 : params.term) == null ? void 0 : _d.termType
       )} which reflects the specific ${glossaryTypeLink((_e = params == null ? void 0 : params.product) == null ? void 0 : _e.termType)}.`;
     },
+    "should use a specific term": ({ params }) => {
+      var _a, _b, _c;
+      return `You have used ${termLink({
+        id: (_a = params == null ? void 0 : params.term) == null ? void 0 : _a["@id"],
+        name: (_b = params == null ? void 0 : params.term) == null ? void 0 : _b.name
+      })}, which does not say what was used.
+    If you know it, choose the specific ${glossaryTypeLink((_c = params == null ? void 0 : params.term) == null ? void 0 : _c.termType)} term instead:
+    background emissions, characterisation factors and completeness all depend on it.`;
+    },
     "should not use several terms describing the same product": ({ params }) => {
       var _a, _b, _c, _d;
       const isFertiliser = ((_a = params == null ? void 0 : params.term) == null ? void 0 : _a.termType) === schema.TermTermType.organicFertiliser;
@@ -1694,6 +1769,12 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     "must specify is it an animal feed": () => `This Cycle is an animal production Cycle and this Input could be an animal feed or could be for another use.
     Please specify the ${schemaLink("Input#isAnimalFeed", "isAnimalFeed")} field on this Input.
     Knowing the fate is essential to distinguish Inputs between those which are fed to animals and those which are used for other purposes.`,
+    "isAnimalFeed not allowed on a non-animal cycle": ({ params }) => `This Cycle does not produce animals: it has no ${schemaLink("Cycle#animals", "animals")} and no ${glossaryTypeLink(
+      schema.TermTermType.liveAnimal
+    )}, ${glossaryTypeLink(schema.TermTermType.animalProduct)} or ${glossaryTypeLink(
+      schema.TermTermType.liveAquaticSpecies
+    )} Product, so ${(params == null ? void 0 : params.term) ? code(params.term.name || params.term["@id"]) : "this Input"} cannot be fed to animals.
+    Please remove the ${schemaLink("Input#isAnimalFeed", "isAnimalFeed")} field${(params == null ? void 0 : params.current) === void 0 ? "" : ` (currently ${code(`${params.current}`)})`} from this Input.`,
     "should specify a treatment when experimentDesign is specified": () => `You have specified that this Source uses an experimental design, but have not specified the treatment for this Cycle.
     Adding the treatment provides important meta-data and will enable greater re-use of these data.
     Add the ${schemaLink("Cycle#treatment", "treatment")} field to the Cycle.
@@ -1837,7 +1918,7 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     ${((_a = params == null ? void 0 : params.term) == null ? void 0 : _a.termType) === schema.TermTermType.measurement ? `This Measurement has additional restrictions and needs either a ${code("value")} or both a ${code("min")} and ${code("max")} specified.
           Please consider adding both the ${code("min")} and the ${code("max")}, or delete the Measurement.` : ""}`;
     },
-    "must specify water type for ponds": ({ params }) => `For Sites with ${schemaLink("Site#siteType", "siteType")} = ${code("pond")}, you must specify the ${externalNodeLink(
+    "must specify water type for ponds": ({ params }) => `You must specify the ${externalNodeLink(
       {
         "@type": schema.NodeType.Term,
         "@id": "waterSalinity",
@@ -1854,7 +1935,7 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
         name: "Brackish water"
       }
     )}).
-    This will allow us to calculate methane emissions from constructed waterbodies.
+    This will allow us to calculate methane emissions from the waterbody.
     ${(params == null ? void 0 : params.products) ? `Note: our gap-filling model can only work when the lookup ${code("defaultSalinity")} is set for all products,
         but we are currently missing a value for: ${joinValues(params.products)}.` : ""}`,
     "invalid water salinity": ({ params }) => `The water type ${params == null ? void 0 : params.current} is not consistent with the Water salinity you specified.
@@ -1967,6 +2048,19 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
       `Completeness#${params.expected}`,
       params.expected
     )}, none of the data in the completeness area can have missing or blank values.`,
+    "must have a value or a distance if complete": ({ params }) => {
+      var _a, _b;
+      return `If completeness is set to true for ${schemaLink(
+        `Completeness#${params.expected}`,
+        params.expected
+      )}, every Transport must have a ${schemaLink("Transport#value", "value")} (in tkm) or a ${schemaLink(
+        "Transport#distance",
+        "distance"
+      )} (in km). This ${termLink({
+        id: (_a = params.term) == null ? void 0 : _a["@id"],
+        name: (_b = params.term) == null ? void 0 : _b.name
+      })} has neither.`;
+    },
     "primary product cannot be an input": ({ params }) => params.siteType === schema.SiteSiteType["agri-food processor"] ? `For a processing cycle, the primary Product must not also be an Input into the cycle.
   This ensures we reflect the full process rather than just single sub-processes.
   Use Transformations if needed to represent additional processing steps rather than new Cycles.` : "The primary Product must not also be an Input into the cycle.",
@@ -2002,19 +2096,24 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
       "Saplings"
     )} used divided by the number of possible Cycles in the plantation's lifespan.
     See the ${guideLink("guide-file-upload-special-cases", "special upload case")} for more details.`,
-    "seed cannot be used as an input here": ({ params }) => `A plantation crop is established from saplings rather than sown, so a plantation Cycle records ${externalNodeLink(
+    "seed cannot be used as an input here": ({ params }) => `The Cycle only represents plantation crops, which are established from saplings rather than sown, so ${externalNodeLink(
       {
         "@type": schema.NodeType.Term,
         "@id": String(params.expected),
         name: "Saplings, depreciated amount per Cycle"
       }
-    )} and not ${code(params.current)}.
-    Remove the ${code(
-      params.current
-    )} Input, or, if it was sown as a cover crop under the plantation, add the ${termLink({
-      id: "coverCrop",
-      name: "Cover crop"
-    })} Practice to the Cycle.`,
+    )} should be used instead of ${code(params.current)}.
+    If this is a case of intercropping, add the relevant ${code(schema.TermTermType.landCover)} Practices to the Cycle, or, if it was sown as a cover crop under the plantation, add the ${termLink(
+      {
+        id: "coverCrop",
+        name: "Cover crop"
+      }
+    )} Practice.`,
+    "saplingsDepreciatedAmountPerCycle cannot be used as an input here": ({ params }) => `The Cycle only represents non-plantation crops, so ${termLink({
+      id: String(params.expected),
+      name: "Seed"
+    })} should be used instead of ${code(params.current)}.
+    If this is a case of intercropping, add the relevant ${code(schema.TermTermType.landCover)} Practices to the Cycle.`,
     "must use the depreciated term": ({ params }) => {
       var _a, _b;
       return `${code(
@@ -2073,6 +2172,10 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     "must be in the same format as endDate": () => `The date format does not match the format of ${code("endDate")}. You must use the same date format for both fields.`,
     "must be at least equal to the minimum value": ({ params: { min } }) => `Must be at least equal to ${min}`,
     "must equal to endDate - startDate in days": ({ params: { expected } }) => `Must be equal to ${code("endDate")} - ${code("startDate")} in days (inclusive of the ${code("startDate")} and ${code("endDate")} days) (~${expected})`,
+    "must be one year prior to endDate": ({ params: { current, expected } }) => `With a ${schemaLink("Cycle#startDateDefinition", "startDateDefinition")} of ${code("one year prior")}, the ${code(
+      "startDate"
+    )} must be the day after the ${code("endDate")} one year earlier, so that the Cycle covers exactly one year.
+    Your ${code("startDate")} is ${code(current)}; it should be ${code(expected)}.`,
     "must equal to endDate - startDate in decimal years": ({ params: { expected } }) => `Must be equal to ${code("endDate")} - ${code("startDate")} in years (~${expected})`,
     "must be more than or equal to other crop residues": ({ params: { expected } }) => `Must be more than or equal to sum(${expected.join(" + ")})`,
     "should add missing inputs": ({ params: { expected } }) => `Should add missing inputs: ${listAsCode(expected)}`,

package/file-errors/public-api.mjs

@@ -200,6 +200,11 @@ var validations = [
     level: "error",
     message: "longFallowDuration must be lower than 5 years"
   },
+  {
+    function: "validate_plantationLifespan",
+    level: "error",
+    message: "must be greater than or equal to plantationProductiveLifespan"
+  },
   {
     function: "validate_waterRegime_rice_products",
     level: "error",
@@ -425,6 +430,11 @@ var validations = [
     level: "warning",
     message: "should specify the fate of cropResidue"
   },
+  {
+    function: "validate_cycleDuration",
+    level: "error",
+    message: "must be one year prior to endDate"
+  },
   {
     function: "validate_cycleDuration",
     level: "error",
@@ -625,6 +635,11 @@ var validations = [
     level: "error",
     message: "must specify is it an animal feed"
   },
+  {
+    function: "validate_isAnimalFeed_animal_cycle",
+    level: "error",
+    message: "isAnimalFeed not allowed on a non-animal cycle"
+  },
   {
     function: "validate_saplings",
     level: "error",
@@ -635,6 +650,11 @@ var validations = [
     level: "error",
     message: "seed cannot be used as an input here"
   },
+  {
+    function: "validate_saplings_depreciated",
+    level: "error",
+    message: "saplingsDepreciatedAmountPerCycle cannot be used as an input here"
+  },
   {
     function: "validate_material_depreciated",
     level: "error",
@@ -645,6 +665,11 @@ var validations = [
     level: "error",
     message: "must be a product"
   },
+  {
+    function: "validate_input_unspecified_term",
+    level: "warning",
+    message: "should use a specific term"
+  },
   {
     function: "_validate_all_values",
     level: "warning",
@@ -680,6 +705,11 @@ var validations = [
     level: "error",
     message: "must not be blank if complete"
   },
+  {
+    function: "validate_completeness_transport",
+    level: "error",
+    message: "must have a value or a distance if complete"
+  },
   {
     function: "validate_has_termType",
     level: "warning",
@@ -749,6 +779,11 @@ var validations = [
     function: "validate_excreta_inputs_products",
     level: "error",
     message: "must be included as an Input"
+  },
+  {
+    function: "validate_transformation_inputs_value",
+    level: "error",
+    message: "must be specified for multiple Inputs with the same term"
   }
 ];
 
@@ -1128,6 +1163,20 @@ var guidePageId = (nodeType2, errorMessage) => {
 var mapErrorMessage = "does not contain latitude and longitude";
 var allowedDataPathsLabels = Object.values(SchemaType);
 var isInfrastructureInputTermType = (dataPath = "") => /infrastructure\[\d+\]\.inputs\[\d+\]\.term\.termType$/.test(dataPath);
+var termTypeRestrictingFields = {
+  [SchemaType.Practice]: {
+    variety: [TermTermType.landCover],
+    ownershipStatus: [TermTermType.operation]
+  }
+};
+var isNodeTermTypeRule = (schemaPath = "") => /^#\/allOf\/\d+\/then\/properties\/term\/properties\/termType\/enum$/.test(schemaPath);
+var sameValues = (values = [], others = []) => values.length === others.length && values.every((value) => others.includes(value));
+var termTypeRestrictingField = (nodeType2, schemaPath, allowedValues) => {
+  var _a;
+  return isNodeTermTypeRule(schemaPath) ? (_a = Object.entries(termTypeRestrictingFields[nodeType2] || {}).find(
+    ([, termTypes]) => sameValues(termTypes, allowedValues)
+  )) == null ? void 0 : _a[0] : void 0;
+};
 var idPatternError = (chars) => `You can only use the following characters for this field: ${chars.join(", ")}`;
 var noTillage = { id: "noTillage", name: "No tillage" };
 var pastureGrass = { id: "pastureGrass", name: "Pasture grass" };
@@ -1340,9 +1389,11 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     ${errorCount === 1 ? "Please check the measurement, its depth intervals, and the dates of the measurement or update the soil texture if needed." : "Please check your measurements, their depth intervals, and the dates of the measurements or update the soil textures if needed."}`;
     },
     "should be equal to one of the allowed values": ({ params, dataPath, schemaPath }, count, errors) => {
-      var _a;
+      var _a, _b;
       const paths = parseDataPath(dataPath);
-      const values = paths.length >= 2 ? pluralize(paths[paths.length - 1].path, ((_a = params == null ? void 0 : params.allowedValues) == null ? void 0 : _a.length) || 0) : "values";
+      const nodeLabel = (_a = paths[paths.length - 3]) == null ? void 0 : _a.label;
+      const restrictingField = dataPath.endsWith("term.termType") ? termTypeRestrictingField(nodeLabel, schemaPath, params == null ? void 0 : params.allowedValues) : null;
+      const values = paths.length >= 2 ? pluralize(paths[paths.length - 1].path, ((_b = params == null ? void 0 : params.allowedValues) == null ? void 0 : _b.length) || 0) : "values";
       const schemaPathMatch = schemaPath == null ? void 0 : schemaPath.split("/").slice(0, 3).join("/");
       const ifError = schemaPathMatch ? errors.find(
         (error) => {
@@ -1357,7 +1408,11 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
       return [
         isInfrastructureInputTermType(dataPath) ? `Only terms in the ${listAsCodeWithAnd(params == null ? void 0 : params.allowedValues)} glossaries can be added as inputs to Site
         infrastructure. Other inputs, e.g., ${code("fuel")}, should be specified on the Cycle.
-        You can use the ${schemaLink("Input#operation", "operation")} field on inputs to specify what the input is for.` : dataPath.endsWith("term.termType") ? [
+        You can use the ${schemaLink("Input#operation", "operation")} field on inputs to specify what the input is for.` : restrictingField ? `The ${schemaLink(`${nodeLabel}#${restrictingField}`, restrictingField)} field can only be added to ${pluralize(
+          nodeLabel,
+          0
+        )} using a term from the following glossaries: ${listAsCode(params == null ? void 0 : params.allowedValues)}.
+        Please either remove ${code(restrictingField)} from this ${nodeLabel}, or change the Term to one from the glossaries listed above.` : dataPath.endsWith("term.termType") ? [
           `For ${pluralize(
             paths[paths.length - 3].label,
             0
@@ -1389,6 +1444,10 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     "longFallowDuration must be lower than 5 years": () => `Your long fallow duration is greater than five years.
     Fallow is defined by FAOSTAT as land left uncultivated for between 1 and 5 years,
     and this definition is used for HESTIA also.`,
+    "must be greater than or equal to plantationProductiveLifespan": ({ params }) => `The ${termLink({ id: "plantationLifespan", name: "Plantation lifespan" })} (${code(params == null ? void 0 : params.current)} days)
+    is shorter than the ${termLink({ id: "plantationProductiveLifespan", name: "Plantation productive lifespan" })}
+    (${code(params == null ? void 0 : params.min)} days).
+    The productive lifespan is part of the plantation lifespan, so it cannot be longer. Please check both values.`,
     "should be more than the cropping duration": ({ params }) => `The ${schemaLink(
       "Cycle#cycleDuration",
       "cycleDuration"
@@ -1430,6 +1489,13 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     },
     "must be equal to previous product multiplied by the share": () => `Products from a transformation which are an Input in to the next transformation must follow the following rule:
     ${code("previous.product.value * current.transformedShare / 100 == current.input.value")}`,
+    "must be specified for multiple Inputs with the same term": ({ params }) => {
+      var _a, _b;
+      return `There are multiple Inputs of ${code(((_a = params == null ? void 0 : params.term) == null ? void 0 : _a.name) || ((_b = params == null ? void 0 : params.term) == null ? void 0 : _b["@id"]))} in this Transformation
+    which only differ by fields other than ${code("variety")} or ${code("fate")}, so the ${code("transformedShare")}
+    cannot tell how the Product ${code("value")} should be split between them.
+    Please specify the ${code("value")} of each of these Inputs.`;
+    },
     "at least one Input must be a Product of the Cycle": () => `A Transformation converts a Product from a Cycle into another Product.
     Therefore, at least one Input into the Transformation must be a Product of the Cycle.`,
     "must have only one entry with the same term.termType = excretaManagement": () => `There can only be one Practice of type excretaManagement in a Cycle.
@@ -1477,6 +1543,15 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
         (_d = params == null ? void 0 : params.term) == null ? void 0 : _d.termType
       )} which reflects the specific ${glossaryTypeLink((_e = params == null ? void 0 : params.product) == null ? void 0 : _e.termType)}.`;
     },
+    "should use a specific term": ({ params }) => {
+      var _a, _b, _c;
+      return `You have used ${termLink({
+        id: (_a = params == null ? void 0 : params.term) == null ? void 0 : _a["@id"],
+        name: (_b = params == null ? void 0 : params.term) == null ? void 0 : _b.name
+      })}, which does not say what was used.
+    If you know it, choose the specific ${glossaryTypeLink((_c = params == null ? void 0 : params.term) == null ? void 0 : _c.termType)} term instead:
+    background emissions, characterisation factors and completeness all depend on it.`;
+    },
     "should not use several terms describing the same product": ({ params }) => {
       var _a, _b, _c, _d;
       const isFertiliser = ((_a = params == null ? void 0 : params.term) == null ? void 0 : _a.termType) === TermTermType.organicFertiliser;
@@ -1692,6 +1767,12 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     "must specify is it an animal feed": () => `This Cycle is an animal production Cycle and this Input could be an animal feed or could be for another use.
     Please specify the ${schemaLink("Input#isAnimalFeed", "isAnimalFeed")} field on this Input.
     Knowing the fate is essential to distinguish Inputs between those which are fed to animals and those which are used for other purposes.`,
+    "isAnimalFeed not allowed on a non-animal cycle": ({ params }) => `This Cycle does not produce animals: it has no ${schemaLink("Cycle#animals", "animals")} and no ${glossaryTypeLink(
+      TermTermType.liveAnimal
+    )}, ${glossaryTypeLink(TermTermType.animalProduct)} or ${glossaryTypeLink(
+      TermTermType.liveAquaticSpecies
+    )} Product, so ${(params == null ? void 0 : params.term) ? code(params.term.name || params.term["@id"]) : "this Input"} cannot be fed to animals.
+    Please remove the ${schemaLink("Input#isAnimalFeed", "isAnimalFeed")} field${(params == null ? void 0 : params.current) === void 0 ? "" : ` (currently ${code(`${params.current}`)})`} from this Input.`,
     "should specify a treatment when experimentDesign is specified": () => `You have specified that this Source uses an experimental design, but have not specified the treatment for this Cycle.
     Adding the treatment provides important meta-data and will enable greater re-use of these data.
     Add the ${schemaLink("Cycle#treatment", "treatment")} field to the Cycle.
@@ -1835,7 +1916,7 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     ${((_a = params == null ? void 0 : params.term) == null ? void 0 : _a.termType) === TermTermType.measurement ? `This Measurement has additional restrictions and needs either a ${code("value")} or both a ${code("min")} and ${code("max")} specified.
           Please consider adding both the ${code("min")} and the ${code("max")}, or delete the Measurement.` : ""}`;
     },
-    "must specify water type for ponds": ({ params }) => `For Sites with ${schemaLink("Site#siteType", "siteType")} = ${code("pond")}, you must specify the ${externalNodeLink(
+    "must specify water type for ponds": ({ params }) => `You must specify the ${externalNodeLink(
       {
         "@type": NodeType.Term,
         "@id": "waterSalinity",
@@ -1852,7 +1933,7 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
         name: "Brackish water"
       }
     )}).
-    This will allow us to calculate methane emissions from constructed waterbodies.
+    This will allow us to calculate methane emissions from the waterbody.
     ${(params == null ? void 0 : params.products) ? `Note: our gap-filling model can only work when the lookup ${code("defaultSalinity")} is set for all products,
         but we are currently missing a value for: ${joinValues(params.products)}.` : ""}`,
     "invalid water salinity": ({ params }) => `The water type ${params == null ? void 0 : params.current} is not consistent with the Water salinity you specified.
@@ -1965,6 +2046,19 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
       `Completeness#${params.expected}`,
       params.expected
     )}, none of the data in the completeness area can have missing or blank values.`,
+    "must have a value or a distance if complete": ({ params }) => {
+      var _a, _b;
+      return `If completeness is set to true for ${schemaLink(
+        `Completeness#${params.expected}`,
+        params.expected
+      )}, every Transport must have a ${schemaLink("Transport#value", "value")} (in tkm) or a ${schemaLink(
+        "Transport#distance",
+        "distance"
+      )} (in km). This ${termLink({
+        id: (_a = params.term) == null ? void 0 : _a["@id"],
+        name: (_b = params.term) == null ? void 0 : _b.name
+      })} has neither.`;
+    },
     "primary product cannot be an input": ({ params }) => params.siteType === SiteSiteType["agri-food processor"] ? `For a processing cycle, the primary Product must not also be an Input into the cycle.
   This ensures we reflect the full process rather than just single sub-processes.
   Use Transformations if needed to represent additional processing steps rather than new Cycles.` : "The primary Product must not also be an Input into the cycle.",
@@ -2000,19 +2094,24 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
       "Saplings"
     )} used divided by the number of possible Cycles in the plantation's lifespan.
     See the ${guideLink("guide-file-upload-special-cases", "special upload case")} for more details.`,
-    "seed cannot be used as an input here": ({ params }) => `A plantation crop is established from saplings rather than sown, so a plantation Cycle records ${externalNodeLink(
+    "seed cannot be used as an input here": ({ params }) => `The Cycle only represents plantation crops, which are established from saplings rather than sown, so ${externalNodeLink(
       {
         "@type": NodeType.Term,
         "@id": String(params.expected),
         name: "Saplings, depreciated amount per Cycle"
       }
-    )} and not ${code(params.current)}.
-    Remove the ${code(
-      params.current
-    )} Input, or, if it was sown as a cover crop under the plantation, add the ${termLink({
-      id: "coverCrop",
-      name: "Cover crop"
-    })} Practice to the Cycle.`,
+    )} should be used instead of ${code(params.current)}.
+    If this is a case of intercropping, add the relevant ${code(TermTermType.landCover)} Practices to the Cycle, or, if it was sown as a cover crop under the plantation, add the ${termLink(
+      {
+        id: "coverCrop",
+        name: "Cover crop"
+      }
+    )} Practice.`,
+    "saplingsDepreciatedAmountPerCycle cannot be used as an input here": ({ params }) => `The Cycle only represents non-plantation crops, so ${termLink({
+      id: String(params.expected),
+      name: "Seed"
+    })} should be used instead of ${code(params.current)}.
+    If this is a case of intercropping, add the relevant ${code(TermTermType.landCover)} Practices to the Cycle.`,
     "must use the depreciated term": ({ params }) => {
       var _a, _b;
       return `${code(
@@ -2071,6 +2170,10 @@ var createErrorFormatter = ({ renderer: r, urls }) => {
     "must be in the same format as endDate": () => `The date format does not match the format of ${code("endDate")}. You must use the same date format for both fields.`,
     "must be at least equal to the minimum value": ({ params: { min } }) => `Must be at least equal to ${min}`,
     "must equal to endDate - startDate in days": ({ params: { expected } }) => `Must be equal to ${code("endDate")} - ${code("startDate")} in days (inclusive of the ${code("startDate")} and ${code("endDate")} days) (~${expected})`,
+    "must be one year prior to endDate": ({ params: { current, expected } }) => `With a ${schemaLink("Cycle#startDateDefinition", "startDateDefinition")} of ${code("one year prior")}, the ${code(
+      "startDate"
+    )} must be the day after the ${code("endDate")} one year earlier, so that the Cycle covers exactly one year.
+    Your ${code("startDate")} is ${code(current)}; it should be ${code(expected)}.`,
     "must equal to endDate - startDate in decimal years": ({ params: { expected } }) => `Must be equal to ${code("endDate")} - ${code("startDate")} in years (~${expected})`,
     "must be more than or equal to other crop residues": ({ params: { expected } }) => `Must be more than or equal to sum(${expected.join(" + ")})`,
     "should add missing inputs": ({ params: { expected } }) => `Should add missing inputs: ${listAsCode(expected)}`,

package/index.js

@@ -208,6 +208,11 @@ var validations = [
     level: "error",
     message: "longFallowDuration must be lower than 5 years"
   },
+  {
+    function: "validate_plantationLifespan",
+    level: "error",
+    message: "must be greater than or equal to plantationProductiveLifespan"
+  },
   {
     function: "validate_waterRegime_rice_products",
     level: "error",
@@ -433,6 +438,11 @@ var validations = [
     level: "warning",
     message: "should specify the fate of cropResidue"
   },
+  {
+    function: "validate_cycleDuration",
+    level: "error",
+    message: "must be one year prior to endDate"
+  },
   {
     function: "validate_cycleDuration",
     level: "error",
@@ -633,6 +643,11 @@ var validations = [
     level: "error",
     message: "must specify is it an animal feed"
   },
+  {
+    function: "validate_isAnimalFeed_animal_cycle",
+    level: "error",
+    message: "isAnimalFeed not allowed on a non-animal cycle"
+  },
   {
     function: "validate_saplings",
     level: "error",
@@ -643,6 +658,11 @@ var validations = [
     level: "error",
     message: "seed cannot be used as an input here"
   },
+  {
+    function: "validate_saplings_depreciated",
+    level: "error",
+    message: "saplingsDepreciatedAmountPerCycle cannot be used as an input here"
+  },
   {
     function: "validate_material_depreciated",
     level: "error",
@@ -653,6 +673,11 @@ var validations = [
     level: "error",
     message: "must be a product"
   },
+  {
+    function: "validate_input_unspecified_term",
+    level: "warning",
+    message: "should use a specific term"
+  },
   {
     function: "_validate_all_values",
     level: "warning",
@@ -688,6 +713,11 @@ var validations = [
     level: "error",
     message: "must not be blank if complete"
   },
+  {
+    function: "validate_completeness_transport",
+    level: "error",
+    message: "must have a value or a distance if complete"
+  },
   {
     function: "validate_has_termType",
     level: "warning",
@@ -757,6 +787,11 @@ var validations = [
     function: "validate_excreta_inputs_products",
     level: "error",
     message: "must be included as an Input"
+  },
+  {
+    function: "validate_transformation_inputs_value",
+    level: "error",
+    message: "must be specified for multiple Inputs with the same term"
   }
 ];
 var validation_default = {

package/index.mjs

@@ -206,6 +206,11 @@ var validations = [
     level: "error",
     message: "longFallowDuration must be lower than 5 years"
   },
+  {
+    function: "validate_plantationLifespan",
+    level: "error",
+    message: "must be greater than or equal to plantationProductiveLifespan"
+  },
   {
     function: "validate_waterRegime_rice_products",
     level: "error",
@@ -431,6 +436,11 @@ var validations = [
     level: "warning",
     message: "should specify the fate of cropResidue"
   },
+  {
+    function: "validate_cycleDuration",
+    level: "error",
+    message: "must be one year prior to endDate"
+  },
   {
     function: "validate_cycleDuration",
     level: "error",
@@ -631,6 +641,11 @@ var validations = [
     level: "error",
     message: "must specify is it an animal feed"
   },
+  {
+    function: "validate_isAnimalFeed_animal_cycle",
+    level: "error",
+    message: "isAnimalFeed not allowed on a non-animal cycle"
+  },
   {
     function: "validate_saplings",
     level: "error",
@@ -641,6 +656,11 @@ var validations = [
     level: "error",
     message: "seed cannot be used as an input here"
   },
+  {
+    function: "validate_saplings_depreciated",
+    level: "error",
+    message: "saplingsDepreciatedAmountPerCycle cannot be used as an input here"
+  },
   {
     function: "validate_material_depreciated",
     level: "error",
@@ -651,6 +671,11 @@ var validations = [
     level: "error",
     message: "must be a product"
   },
+  {
+    function: "validate_input_unspecified_term",
+    level: "warning",
+    message: "should use a specific term"
+  },
   {
     function: "_validate_all_values",
     level: "warning",
@@ -686,6 +711,11 @@ var validations = [
     level: "error",
     message: "must not be blank if complete"
   },
+  {
+    function: "validate_completeness_transport",
+    level: "error",
+    message: "must have a value or a distance if complete"
+  },
   {
     function: "validate_has_termType",
     level: "warning",
@@ -755,6 +785,11 @@ var validations = [
     function: "validate_excreta_inputs_products",
     level: "error",
     message: "must be included as an Input"
+  },
+  {
+    function: "validate_transformation_inputs_value",
+    level: "error",
+    message: "must be specified for multiple Inputs with the same term"
   }
 ];
 var validation_default = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hestia-earth/data-validation",
-  "version": "0.41.7",
+  "version": "0.41.9",
   "description": "HESTIA Data Validation library",
   "main": "index.js",
   "module": "index.mjs",

package/validation.json

@@ -195,6 +195,11 @@
       "level": "error",
       "message": "longFallowDuration must be lower than 5 years"
     },
+    {
+      "function": "validate_plantationLifespan",
+      "level": "error",
+      "message": "must be greater than or equal to plantationProductiveLifespan"
+    },
     {
       "function": "validate_waterRegime_rice_products",
       "level": "error",
@@ -420,6 +425,11 @@
       "level": "warning",
       "message": "should specify the fate of cropResidue"
     },
+    {
+      "function": "validate_cycleDuration",
+      "level": "error",
+      "message": "must be one year prior to endDate"
+    },
     {
       "function": "validate_cycleDuration",
       "level": "error",
@@ -620,6 +630,11 @@
       "level": "error",
       "message": "must specify is it an animal feed"
     },
+    {
+      "function": "validate_isAnimalFeed_animal_cycle",
+      "level": "error",
+      "message": "isAnimalFeed not allowed on a non-animal cycle"
+    },
     {
       "function": "validate_saplings",
       "level": "error",
@@ -630,6 +645,11 @@
       "level": "error",
       "message": "seed cannot be used as an input here"
     },
+    {
+      "function": "validate_saplings_depreciated",
+      "level": "error",
+      "message": "saplingsDepreciatedAmountPerCycle cannot be used as an input here"
+    },
     {
       "function": "validate_material_depreciated",
       "level": "error",
@@ -640,6 +660,11 @@
       "level": "error",
       "message": "must be a product"
     },
+    {
+      "function": "validate_input_unspecified_term",
+      "level": "warning",
+      "message": "should use a specific term"
+    },
     {
       "function": "_validate_all_values",
       "level": "warning",
@@ -675,6 +700,11 @@
       "level": "error",
       "message": "must not be blank if complete"
     },
+    {
+      "function": "validate_completeness_transport",
+      "level": "error",
+      "message": "must have a value or a distance if complete"
+    },
     {
       "function": "validate_has_termType",
       "level": "warning",
@@ -744,6 +774,11 @@
       "function": "validate_excreta_inputs_products",
       "level": "error",
       "message": "must be included as an Input"
+    },
+    {
+      "function": "validate_transformation_inputs_value",
+      "level": "error",
+      "message": "must be specified for multiple Inputs with the same term"
     }
   ]
 }