ochre-sdk 1.0.76 → 1.0.78

package/dist/getters.d.mts

@@ -3,7 +3,7 @@ import { LanguageCodes, Property, PropertyLike, PropertyValueContent, SetItemPro
 /**
  * Options for property search operations.
  */
-type PropertyOptions = {
+export type PropertyOptions = {
   /**
     Whether to recursively search through nested properties.
     */
@@ -23,10 +23,10 @@ type SearchableProperty<T extends LanguageCodes> = PropertyLike<T>;
  * @param options - Search options, including whether to include nested properties
  * @returns The matching Property object, or null if not found
  */
-declare function getPropertyByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableUuid: string, options?: PropertyOptions): Property<T> | null;
-declare function getPropertyByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableUuid: string, options?: PropertyOptions): SetItemProperty<T> | null;
-declare function getPropertyByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableUuid: string, options?: PropertyOptions): SimplifiedProperty<T> | null;
-declare function getPropertyByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableUuid: string, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
+export declare function getPropertyByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableUuid: string, options?: PropertyOptions): Property<T> | null;
+export declare function getPropertyByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableUuid: string, options?: PropertyOptions): SetItemProperty<T> | null;
+export declare function getPropertyByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableUuid: string, options?: PropertyOptions): SimplifiedProperty<T> | null;
+export declare function getPropertyByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableUuid: string, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
 /**
  * Retrieves all values for a property with the given variable UUID.
  *
@@ -35,7 +35,7 @@ declare function getPropertyByVariableUuid<T extends LanguageCodes = LanguageCod
  * @param options - Search options, including whether to include nested properties
  * @returns Array of property values, or null if property not found
  */
-declare function getPropertyValuesByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableUuid: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
+export declare function getPropertyValuesByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableUuid: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
 /**
  * Retrieves all value contents for a property with the given variable UUID.
  *
@@ -44,7 +44,7 @@ declare function getPropertyValuesByVariableUuid<T extends LanguageCodes = Langu
  * @param options - Search options, including whether to include nested properties
  * @returns Array of property value contents, or null if property not found
  */
-declare function getPropertyValueContentsByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableUuid: string, options?: PropertyOptions): Array<PropertyContent<T>> | null;
+export declare function getPropertyValueContentsByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableUuid: string, options?: PropertyOptions): Array<PropertyContent<T>> | null;
 /**
  * Gets the first value of a property with the given variable UUID.
  *
@@ -53,7 +53,7 @@ declare function getPropertyValueContentsByVariableUuid<T extends LanguageCodes
  * @param options - Search options, including whether to include nested properties
  * @returns The first property value, or null if property not found
  */
-declare function getPropertyValueByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableUuid: string, options?: PropertyOptions): PropertyValueContent<T> | null;
+export declare function getPropertyValueByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableUuid: string, options?: PropertyOptions): PropertyValueContent<T> | null;
 /**
  * Gets the first value content of a property with the given variable UUID.
  *
@@ -62,7 +62,7 @@ declare function getPropertyValueByVariableUuid<T extends LanguageCodes = Langua
  * @param options - Search options, including whether to include nested properties
  * @returns The first property value content, or null if property not found
  */
-declare function getPropertyValueContentByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableUuid: string, options?: PropertyOptions): PropertyContent<T> | null;
+export declare function getPropertyValueContentByVariableUuid<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableUuid: string, options?: PropertyOptions): PropertyContent<T> | null;
 /**
  * Finds a property by its variable label in an array of properties.
  *
@@ -71,10 +71,10 @@ declare function getPropertyValueContentByVariableUuid<T extends LanguageCodes =
  * @param options - Search options, including whether to include nested properties
  * @returns The matching Property object, or null if not found
  */
-declare function getPropertyByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableLabel: string, options?: PropertyOptions): Property<T> | null;
-declare function getPropertyByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableLabel: string, options?: PropertyOptions): SetItemProperty<T> | null;
-declare function getPropertyByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableLabel: string, options?: PropertyOptions): SimplifiedProperty<T> | null;
-declare function getPropertyByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableLabel: string, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
+export declare function getPropertyByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableLabel: string, options?: PropertyOptions): Property<T> | null;
+export declare function getPropertyByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableLabel: string, options?: PropertyOptions): SetItemProperty<T> | null;
+export declare function getPropertyByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableLabel: string, options?: PropertyOptions): SimplifiedProperty<T> | null;
+export declare function getPropertyByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableLabel: string, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
 /**
  * Finds a property by its variable label and all values.
  *
@@ -84,10 +84,10 @@ declare function getPropertyByVariableLabel<T extends LanguageCodes = LanguageCo
  * @param options - Search options, including whether to include nested properties
  * @returns The matching Property object, or null if not found or all values do not match
  */
-declare function getPropertyByVariableLabelAndValues<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableLabel: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): Property<T> | null;
-declare function getPropertyByVariableLabelAndValues<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableLabel: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): SetItemProperty<T> | null;
-declare function getPropertyByVariableLabelAndValues<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableLabel: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): SimplifiedProperty<T> | null;
-declare function getPropertyByVariableLabelAndValues<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableLabel: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValues<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableLabel: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): Property<T> | null;
+export declare function getPropertyByVariableLabelAndValues<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableLabel: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): SetItemProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValues<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableLabel: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): SimplifiedProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValues<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableLabel: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
 /**
  * Finds a property by its variable label and all value contents.
  *
@@ -97,10 +97,10 @@ declare function getPropertyByVariableLabelAndValues<T extends LanguageCodes = L
  * @param options - Search options, including whether to include nested properties
  * @returns The matching Property object, or null if not found or all value contents do not match
  */
-declare function getPropertyByVariableLabelAndValueContents<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableLabel: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): Property<T> | null;
-declare function getPropertyByVariableLabelAndValueContents<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableLabel: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): SetItemProperty<T> | null;
-declare function getPropertyByVariableLabelAndValueContents<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableLabel: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): SimplifiedProperty<T> | null;
-declare function getPropertyByVariableLabelAndValueContents<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableLabel: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValueContents<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableLabel: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): Property<T> | null;
+export declare function getPropertyByVariableLabelAndValueContents<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableLabel: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): SetItemProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValueContents<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableLabel: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): SimplifiedProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValueContents<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableLabel: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
 /**
  * Finds a property by its variable label and one value.
  *
@@ -110,10 +110,10 @@ declare function getPropertyByVariableLabelAndValueContents<T extends LanguageCo
  * @param options - Search options, including whether to include nested properties
  * @returns The matching Property object, or null if not found or value does not match
  */
-declare function getPropertyByVariableLabelAndValue<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableLabel: string, value: PropertyValueContent<T>, options?: PropertyOptions): Property<T> | null;
-declare function getPropertyByVariableLabelAndValue<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableLabel: string, value: PropertyValueContent<T>, options?: PropertyOptions): SetItemProperty<T> | null;
-declare function getPropertyByVariableLabelAndValue<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableLabel: string, value: PropertyValueContent<T>, options?: PropertyOptions): SimplifiedProperty<T> | null;
-declare function getPropertyByVariableLabelAndValue<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableLabel: string, value: PropertyValueContent<T>, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValue<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableLabel: string, value: PropertyValueContent<T>, options?: PropertyOptions): Property<T> | null;
+export declare function getPropertyByVariableLabelAndValue<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableLabel: string, value: PropertyValueContent<T>, options?: PropertyOptions): SetItemProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValue<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableLabel: string, value: PropertyValueContent<T>, options?: PropertyOptions): SimplifiedProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValue<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableLabel: string, value: PropertyValueContent<T>, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
 /**
  * Finds a property by its variable label and one value content.
  *
@@ -123,10 +123,10 @@ declare function getPropertyByVariableLabelAndValue<T extends LanguageCodes = La
  * @param options - Search options, including whether to include nested properties
  * @returns The matching Property object, or null if not found or value content does not match
  */
-declare function getPropertyByVariableLabelAndValueContent<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableLabel: string, valueContent: PropertyContent<T>, options?: PropertyOptions): Property<T> | null;
-declare function getPropertyByVariableLabelAndValueContent<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableLabel: string, valueContent: PropertyContent<T>, options?: PropertyOptions): SetItemProperty<T> | null;
-declare function getPropertyByVariableLabelAndValueContent<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableLabel: string, valueContent: PropertyContent<T>, options?: PropertyOptions): SimplifiedProperty<T> | null;
-declare function getPropertyByVariableLabelAndValueContent<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableLabel: string, valueContent: PropertyContent<T>, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValueContent<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, variableLabel: string, valueContent: PropertyContent<T>, options?: PropertyOptions): Property<T> | null;
+export declare function getPropertyByVariableLabelAndValueContent<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, variableLabel: string, valueContent: PropertyContent<T>, options?: PropertyOptions): SetItemProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValueContent<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, variableLabel: string, valueContent: PropertyContent<T>, options?: PropertyOptions): SimplifiedProperty<T> | null;
+export declare function getPropertyByVariableLabelAndValueContent<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, variableLabel: string, valueContent: PropertyContent<T>, options?: PropertyOptions): SetItemSimplifiedProperty<T> | null;
 /**
  * Retrieves all values for a property with the given variable label.
  *
@@ -135,7 +135,7 @@ declare function getPropertyByVariableLabelAndValueContent<T extends LanguageCod
  * @param options - Search options, including whether to include nested properties
  * @returns Array of property values, or null if property not found
  */
-declare function getPropertyValuesByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableLabel: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
+export declare function getPropertyValuesByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableLabel: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
 /**
  * Gets the first value of a property with the given variable label.
  *
@@ -144,7 +144,7 @@ declare function getPropertyValuesByVariableLabel<T extends LanguageCodes = Lang
  * @param options - Search options, including whether to include nested properties
  * @returns The first property value, or null if property not found
  */
-declare function getPropertyValueByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableLabel: string, options?: PropertyOptions): PropertyValueContent<T> | null;
+export declare function getPropertyValueByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableLabel: string, options?: PropertyOptions): PropertyValueContent<T> | null;
 /**
  * Gets the first value content of a property with the given variable label.
  *
@@ -153,7 +153,7 @@ declare function getPropertyValueByVariableLabel<T extends LanguageCodes = Langu
  * @param options - Search options, including whether to include nested properties
  * @returns The first property value content, or null if property not found
  */
-declare function getPropertyValueContentByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableLabel: string, options?: PropertyOptions): PropertyContent<T> | null;
+export declare function getPropertyValueContentByVariableLabel<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, variableLabel: string, options?: PropertyOptions): PropertyContent<T> | null;
 /**
  * Gets all unique properties from an array of properties.
  *
@@ -161,10 +161,10 @@ declare function getPropertyValueContentByVariableLabel<T extends LanguageCodes
  * @param options - Search options, including whether to include nested properties
  * @returns Array of unique properties
  */
-declare function getUniqueProperties<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, options?: PropertyOptions): Array<Property<T>>;
-declare function getUniqueProperties<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, options?: PropertyOptions): Array<SetItemProperty<T>>;
-declare function getUniqueProperties<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, options?: PropertyOptions): Array<SimplifiedProperty<T>>;
-declare function getUniqueProperties<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, options?: PropertyOptions): Array<SetItemSimplifiedProperty<T>>;
+export declare function getUniqueProperties<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<Property<T>>, options?: PropertyOptions): Array<Property<T>>;
+export declare function getUniqueProperties<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemProperty<T>>, options?: PropertyOptions): Array<SetItemProperty<T>>;
+export declare function getUniqueProperties<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>, options?: PropertyOptions): Array<SimplifiedProperty<T>>;
+export declare function getUniqueProperties<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SetItemSimplifiedProperty<T>>, options?: PropertyOptions): Array<SetItemSimplifiedProperty<T>>;
 /**
  * Gets all unique property variable labels from an array of properties.
  *
@@ -172,14 +172,14 @@ declare function getUniqueProperties<T extends LanguageCodes = LanguageCodes>(pr
  * @param options - Search options, including whether to include nested properties
  * @returns Array of unique property variable labels
  */
-declare function getUniquePropertyVariableLabels<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, options?: PropertyOptions): Array<string>;
+export declare function getUniquePropertyVariableLabels<T extends LanguageCodes = LanguageCodes>(properties: ReadonlyArray<SearchableProperty<T>>, options?: PropertyOptions): Array<string>;
 /**
  * Get the leaf property values from an array of property values.
  *
  * @param propertyValues - The array of property values to get the leaf property values from
  * @returns The array of leaf property values
  */
-declare function getLeafPropertyValues<T extends LanguageCodes = LanguageCodes>(propertyValues: ReadonlyArray<PropertyValueContent<T>>): Array<PropertyValueContent<T>>;
+export declare function getLeafPropertyValues<T extends LanguageCodes = LanguageCodes>(propertyValues: ReadonlyArray<PropertyValueContent<T>>): Array<PropertyValueContent<T>>;
 /**
  * Filters a property based on a variable label and value content criterion.
  *
@@ -190,9 +190,8 @@ declare function getLeafPropertyValues<T extends LanguageCodes = LanguageCodes>(
  * @param options - Search options, including whether to include nested properties
  * @returns True if the property matches the filter criteria, false otherwise
  */
-declare function filterProperties<T extends LanguageCodes = LanguageCodes>(property: SearchableProperty<T>, filter: {
+export declare function filterProperties<T extends LanguageCodes = LanguageCodes>(property: SearchableProperty<T>, filter: {
   variableLabel: string;
   value: PropertyValueContent<T>;
 }, options?: PropertyOptions): boolean;
-//#endregion
-export { PropertyOptions, filterProperties, getLeafPropertyValues, getPropertyByVariableLabel, getPropertyByVariableLabelAndValue, getPropertyByVariableLabelAndValueContent, getPropertyByVariableLabelAndValueContents, getPropertyByVariableLabelAndValues, getPropertyByVariableUuid, getPropertyValueByVariableLabel, getPropertyValueByVariableUuid, getPropertyValueContentByVariableLabel, getPropertyValueContentByVariableUuid, getPropertyValueContentsByVariableUuid, getPropertyValuesByVariableLabel, getPropertyValuesByVariableUuid, getUniqueProperties, getUniquePropertyVariableLabels };
+//#endregion

package/dist/getters.mjs

@@ -37,13 +37,13 @@ function hasEqualPropertyValueContents(property, valueContents) {
 function searchPropertyResult(properties, options, findDirectResult, transformNestedResult) {
 	const directResult = findDirectResult(properties);
 	if (directResult !== null) return directResult;
-	if (options.includeNestedProperties) for (const property of properties) {
+	if (!options.includeNestedProperties) return null;
+	for (const property of properties) {
 		if (!("properties" in property)) continue;
 		const nestedResult = searchPropertyResult(property.properties, options, findDirectResult, transformNestedResult);
-		if (nestedResult !== null) {
-			const transformedResult = transformNestedResult != null ? transformNestedResult(nestedResult) : nestedResult;
-			if (transformedResult !== null) return transformedResult;
-		}
+		if (nestedResult === null) continue;
+		const transformedResult = transformNestedResult != null ? transformNestedResult(nestedResult) : nestedResult;
+		if (transformedResult !== null) return transformedResult;
 	}
 	return null;
 }
@@ -53,32 +53,7 @@ function getPropertyValuesResult(values, shouldLimitToLeafPropertyValues, should
 	return [...values];
 }
 function clonePropertyValues(values) {
-	const clonedValues = [];
-	for (const value of values) switch (value.dataType) {
-		case "IDREF":
-		case "coordinate":
-		case "date":
-		case "dateTime":
-		case "string":
-			clonedValues.push({
-				...value,
-				content: value.content
-			});
-			break;
-		case "decimal":
-		case "integer":
-		case "time":
-			clonedValues.push({
-				...value,
-				content: value.content
-			});
-			break;
-		case "boolean": clonedValues.push({
-			...value,
-			content: value.content
-		});
-	}
-	return clonedValues;
+	return Array.from(values, (value) => ({ ...value }));
 }
 function getNormalizedProperty(property, shouldLimitToLeafPropertyValues, transformValues) {
 	if (!shouldLimitToLeafPropertyValues) return property;

package/dist/helpers.d.mts

@@ -6,12 +6,11 @@ type FlattenedItem<U, T extends LanguageCodes> = Omit<U, "properties"> & {
 /**
  * The default page size to use for fetching paginated items
  */
-declare const DEFAULT_PAGE_SIZE = 48;
+export declare const DEFAULT_PAGE_SIZE = 48;
 /**
  * Flatten the properties of an item
  * @param item - The item whose properties to flatten
  * @returns The item with the properties flattened
  */
-declare function flattenItemProperties<U extends ItemCategory = ItemCategory, V extends ContainedItemCategory<U> = ContainedItemCategory<U>, T extends LanguageCodes = LanguageCodes, W extends ItemPayloadKind = "topLevel">(item: Item<U, V, T, W>): FlattenedItem<Item<U, V, T, W>, T>;
-//#endregion
-export { DEFAULT_PAGE_SIZE, flattenItemProperties };
+export declare function flattenItemProperties<U extends ItemCategory = ItemCategory, V extends ContainedItemCategory<U> = ContainedItemCategory<U>, T extends LanguageCodes = LanguageCodes, W extends ItemPayloadKind = "topLevel">(item: Item<U, V, T, W>): FlattenedItem<Item<U, V, T, W>, T>;
+//#endregion

package/dist/parsers/helpers.d.mts

@@ -2,32 +2,31 @@ import { MultilingualString } from "./multilingual.mjs";
 import { License } from "../types/index.mjs";
 import { XMLContent, XMLString } from "../xml/types.mjs";
 //#region src/parsers/helpers.d.ts
-type FetchFunction = (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
-type FetchBaseOptions<TLanguages extends ReadonlyArray<string> | undefined = undefined> = {
+export type FetchFunction = (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
+export type FetchBaseOptions<TLanguages extends ReadonlyArray<string> | undefined = undefined> = {
   languages?: TLanguages;
   fetch?: FetchFunction;
 };
-type FetchRuntimeOptions = FetchBaseOptions<ReadonlyArray<string>>;
-type FetchLanguages<TLanguages extends ReadonlyArray<string> | undefined> = TLanguages extends readonly [] ? ReadonlyArray<string> : TLanguages extends ReadonlyArray<string> ? TLanguages : ReadonlyArray<string>;
-type ParserOptions<T extends ReadonlyArray<string>> = {
+export type FetchRuntimeOptions = FetchBaseOptions<ReadonlyArray<string>>;
+export type FetchLanguages<TLanguages extends ReadonlyArray<string> | undefined> = TLanguages extends readonly [] ? ReadonlyArray<string> : TLanguages extends ReadonlyArray<string> ? TLanguages : ReadonlyArray<string>;
+export type ParserOptions<T extends ReadonlyArray<string>> = {
   languages: T;
 };
-declare function getParserOptions<T extends ReadonlyArray<string>>(options: ParserOptions<T>): ParserOptions<T>;
-declare function cleanObject<T extends Record<string, unknown>>(object: T): Partial<T>;
-declare function parseLicense(availability: {
+export declare function getParserOptions<T extends ReadonlyArray<string>>(options: ParserOptions<T>): ParserOptions<T>;
+export declare function cleanObject<T extends Record<string, unknown>>(object: T): Partial<T>;
+export declare function parseLicense(availability: {
   license: XMLString & {
     target?: string;
   };
 } | undefined): License | null;
-declare function parseStringLike(value: XMLString | string | undefined): string | null;
-declare function isXMLContent(value: XMLContent | XMLString): value is XMLContent;
-declare function multilingualFromText<T extends ReadonlyArray<string>>(text: string | {
+export declare function parseStringLike(value: XMLString | string | undefined): string | null;
+export declare function isXMLContent(value: XMLContent | XMLString): value is XMLContent;
+export declare function multilingualFromText<T extends ReadonlyArray<string>>(text: string | {
   text: string;
   richText: string;
 }, options: ParserOptions<T>): MultilingualString<T>;
-declare function parseContentLike<T extends ReadonlyArray<string>>(value: XMLContent | XMLString | string | undefined, options: ParserOptions<T>): MultilingualString<T> | null;
-declare function parseRequiredContentLike<T extends ReadonlyArray<string>>(value: XMLContent | XMLString, options: ParserOptions<T>): MultilingualString<T>;
-declare function parseContentLikeText<T extends ReadonlyArray<string>>(value: XMLContent | XMLString | undefined, options: ParserOptions<T>): string;
-declare function parseStringContent(value: XMLContent | XMLString | string | undefined, options?: ParserOptions<ReadonlyArray<string>>): string;
-//#endregion
-export { FetchBaseOptions, FetchFunction, FetchLanguages, FetchRuntimeOptions, ParserOptions, cleanObject, getParserOptions, isXMLContent, multilingualFromText, parseContentLike, parseContentLikeText, parseLicense, parseRequiredContentLike, parseStringContent, parseStringLike };
+export declare function parseContentLike<T extends ReadonlyArray<string>>(value: XMLContent | XMLString | string | undefined, options: ParserOptions<T>): MultilingualString<T> | null;
+export declare function parseRequiredContentLike<T extends ReadonlyArray<string>>(value: XMLContent | XMLString, options: ParserOptions<T>): MultilingualString<T>;
+export declare function parseContentLikeText<T extends ReadonlyArray<string>>(value: XMLContent | XMLString | undefined, options: ParserOptions<T>): string;
+export declare function parseStringContent(value: XMLContent | XMLString | string | undefined, options?: ParserOptions<ReadonlyArray<string>>): string;
+//#endregion

package/dist/parsers/index.d.mts

@@ -3,62 +3,62 @@ import { Bibliography, ContainedItemCategoryFromOption, ContainedItemCategoryOpt
 import { XMLBibliography, XMLData, XMLDataItem, XMLGalleryData, XMLIdentification, XMLItemLinks, XMLLink, XMLMetadata, XMLNote, XMLPerson, XMLProperty, XMLResource, XMLSetItems, XMLSimplifiedProperty } from "../xml/types.mjs";
 import { ParserOptions, getParserOptions, parseStringLike } from "./helpers.mjs";
 //#region src/parsers/index.d.ts
-type RawOchre = XMLData["result"]["ochre"];
+export type RawOchre = XMLData["result"]["ochre"];
 type ResourceViewParser<T extends ReadonlyArray<string>> = (view: XMLResource["view"], context: Pick<Resource<T, "topLevel">, "belongsTo" | "metadata">) => Webpage<T> | null;
 type SetItemCategoryFromCategories<T extends ReadonlyArray<SetItemCategory> | undefined> = T extends ReadonlyArray<infer U> ? Extract<U, SetItemCategory> : SetItemCategory;
-declare function parseIdentification<T extends ReadonlyArray<string>>(rawIdentification: XMLIdentification, options: ParserOptions<T>): Identification<T>;
-declare function parseNotes<T extends ReadonlyArray<string>>(rawNotes: {
+export declare function parseIdentification<T extends ReadonlyArray<string>>(rawIdentification: XMLIdentification, options: ParserOptions<T>): Identification<T>;
+export declare function parseNotes<T extends ReadonlyArray<string>>(rawNotes: {
   note: Array<XMLNote>;
 } | undefined, options: ParserOptions<T>): Array<Note<T>>;
-declare function parseProperties<T extends ReadonlyArray<string>>(rawProperties: {
+export declare function parseProperties<T extends ReadonlyArray<string>>(rawProperties: {
   property: Array<XMLProperty>;
 } | undefined, options: ParserOptions<T>): Array<Property<T>>;
-declare function parseSimplifiedProperties<T extends ReadonlyArray<string>>(rawProperties: {
+export declare function parseSimplifiedProperties<T extends ReadonlyArray<string>>(rawProperties: {
   property: Array<XMLSimplifiedProperty>;
 } | undefined, options: ParserOptions<T>): Array<SimplifiedProperty<T>>;
-declare function parseLinks<T extends ReadonlyArray<string>>(rawLinks: XMLLink | XMLDataItem | undefined, options: ParserOptions<T>): ItemLinks<T>;
-declare function parseBibliographyList<T extends ReadonlyArray<string>>(rawBibliographies: {
+export declare function parseLinks<T extends ReadonlyArray<string>>(rawLinks: XMLLink | XMLDataItem | undefined, options: ParserOptions<T>): ItemLinks<T>;
+export declare function parseBibliographyList<T extends ReadonlyArray<string>>(rawBibliographies: {
   bibliography: Array<XMLBibliography>;
 } | undefined, options: ParserOptions<T>): Array<Bibliography<T, "embedded">>;
-declare function parsePersonList<T extends ReadonlyArray<string>>(rawPersons: Array<XMLPerson> | undefined, options: ParserOptions<T>): Array<Person<T, "embedded">>;
-declare function parseMetadataLanguages(rawOchre: {
+export declare function parsePersonList<T extends ReadonlyArray<string>>(rawPersons: Array<XMLPerson> | undefined, options: ParserOptions<T>): Array<Person<T, "embedded">>;
+export declare function parseMetadataLanguages(rawOchre: {
   metadata: XMLMetadata;
   languages?: string;
 }): Array<string>;
-declare function resolveLanguages<T extends ReadonlyArray<string>>(requestedLanguages: T, metadataLanguages: Array<string>): T;
-declare function resolveDefaultLanguage<T extends ReadonlyArray<string>>(rawOchre: {
+export declare function resolveLanguages<T extends ReadonlyArray<string>>(requestedLanguages: T | undefined, metadataLanguages: Array<string>): T;
+export declare function resolveDefaultLanguage<T extends ReadonlyArray<string>>(rawOchre: {
   metadata: XMLMetadata;
 }, languages: T): T[number];
-declare function parseMetadata<T extends ReadonlyArray<string>>(rawOchre: {
+export declare function parseMetadata<T extends ReadonlyArray<string>>(rawOchre: {
   uuidBelongsTo: string;
   metadata: XMLMetadata;
 }, options: ParserOptions<T>, defaultLanguage: T[number]): Metadata<T>;
-declare function parseLinkedItems<const TContainedItemCategory extends ContainedItemCategoryOption<ItemCategory> | undefined = undefined, T extends ReadonlyArray<string> = ReadonlyArray<string>>(rawItems: XMLItemLinks | undefined, options: {
+export declare function parseLinkedItems<const TContainedItemCategory extends ContainedItemCategoryOption<ItemCategory> | undefined = undefined, T extends ReadonlyArray<string> = ReadonlyArray<string>>(rawItems: XMLItemLinks | undefined, options: {
   containedItemCategory?: TContainedItemCategory;
   languages: T;
 }): Array<Item<ItemCategory, ContainedItemCategoryFromOption<ItemCategory, TContainedItemCategory>, T, "embedded">>;
-declare function parseSetItems<const TContainedItemCategories extends ReadonlyArray<SetItemCategory> | undefined = undefined, T extends ReadonlyArray<string> = ReadonlyArray<string>>(rawItems: XMLSetItems | undefined, options: {
+export declare function parseSetItems<const TContainedItemCategories extends ReadonlyArray<SetItemCategory> | undefined = undefined, T extends ReadonlyArray<string> = ReadonlyArray<string>>(rawItems: XMLSetItems | undefined, options: {
   containedItemCategories?: TContainedItemCategories;
   languages: T;
 }): Array<SetItem<SetItemCategoryFromCategories<TContainedItemCategories>, T>>;
-declare function parseGallery<T extends ReadonlyArray<string>>(rawData: XMLGalleryData, options: ParserOptions<T>): Gallery<T>;
-declare function parseItem<const TContainedItemCategory extends ContainedItemCategoryOption<ItemCategory> | undefined = undefined, T extends ReadonlyArray<string> = ReadonlyArray<string>>(rawData: XMLData, options: {
+export declare function parseGallery<T extends ReadonlyArray<string>>(rawData: XMLGalleryData, options: ParserOptions<T>): Gallery<T>;
+export declare function parseItem<const TContainedItemCategory extends ContainedItemCategoryOption<ItemCategory> | undefined = undefined, T extends ReadonlyArray<string> = ReadonlyArray<string>>(rawData: XMLData, options: {
   category?: undefined;
   containedItemCategory?: TContainedItemCategory;
   languages: T;
   parseResourceView?: ResourceViewParser<T>;
 }): Item<ItemCategory, ContainedItemCategoryFromOption<ItemCategory, TContainedItemCategory>, T>;
-declare function parseItem<const TCategory extends ItemCategoryOption, const TContainedItemCategory extends ContainedItemCategoryOption<Extract<ItemCategoryFromOption<TCategory>, ItemContainerCategory>> | undefined = undefined, T extends ReadonlyArray<string> = ReadonlyArray<string>>(rawData: XMLData, options: {
+export declare function parseItem<const TCategory extends ItemCategoryOption, const TContainedItemCategory extends ContainedItemCategoryOption<Extract<ItemCategoryFromOption<TCategory>, ItemContainerCategory>> | undefined = undefined, T extends ReadonlyArray<string> = ReadonlyArray<string>>(rawData: XMLData, options: {
   category: TCategory;
   containedItemCategory?: TContainedItemCategory;
   languages: T;
   parseResourceView?: ResourceViewParser<T>;
 }): Item<ItemCategoryFromOption<TCategory>, ContainedItemCategoryFromOption<ItemCategoryFromOption<TCategory>, TContainedItemCategory>, T>;
-declare function parseItem(rawData: XMLData, options: {
+export declare function parseItem(rawData: XMLData, options: {
   category?: ItemCategoryOption;
   containedItemCategory?: ContainedItemCategoryOption<ItemCategory>;
   languages: ReadonlyArray<string>;
   parseResourceView?: ResourceViewParser<ReadonlyArray<string>>;
 }): Item<ItemCategory, SetItemCategory, ReadonlyArray<string>>;
 //#endregion
-export { type ParserOptions, RawOchre, getParserOptions, parseBibliographyList, parseGallery, parseIdentification, parseItem, parseLinkedItems, parseLinks, parseMetadata, parseMetadataLanguages, parseNotes, parsePersonList, parseProperties, parseSetItems, parseSimplifiedProperties, parseStringLike, resolveDefaultLanguage, resolveLanguages };
+export { type ParserOptions, getParserOptions, parseStringLike };

package/dist/parsers/index.mjs

@@ -120,6 +120,24 @@ function emptyContextItem() {
 		content: ""
 	};
 }
+function parseContextNode(rawContextItem) {
+	const node = {
+		tree: rawContextItem.tree[0] == null ? emptyContextItem() : parseContextItem(rawContextItem.tree[0]),
+		project: parseContextItem(rawContextItem.project),
+		heading: []
+	};
+	const headings = rawContextItem.heading ?? [];
+	for (const heading of headings) node.heading.push(parseContextItem(heading));
+	for (const { raw, parsed } of CONTEXT_CATEGORY_MAPPINGS) {
+		const contextValues = rawContextItem[raw] ?? [];
+		for (const contextValue of contextValues) {
+			const parsedItems = node[parsed] ?? [];
+			parsedItems.push(parseContextItem(contextValue));
+			node[parsed] = parsedItems;
+		}
+	}
+	return node;
+}
 function parseContext(rawContext) {
 	const nodes = [];
 	let displayPath = "";
@@ -128,23 +146,7 @@ function parseContext(rawContext) {
 		displayPath ||= rawContextOuterItem.displayPath;
 		for (const rawContextItem of rawContextOuterItem.context) {
 			if (!isXMLContextItem(rawContextItem)) continue;
-			const node = {
-				tree: rawContextItem.tree[0] == null ? emptyContextItem() : parseContextItem(rawContextItem.tree[0]),
-				project: parseContextItem(rawContextItem.project),
-				heading: []
-			};
-			const rawContextValues = rawContextItem;
-			const headings = rawContextValues.heading ?? [];
-			for (const heading of headings) node.heading.push(parseContextItem(heading));
-			for (const { raw, parsed } of CONTEXT_CATEGORY_MAPPINGS) {
-				const contextValues = rawContextValues[raw] ?? [];
-				for (const contextValue of contextValues) {
-					const parsedItems = node[parsed] ?? [];
-					parsedItems.push(parseContextItem(contextValue));
-					node[parsed] = parsedItems;
-				}
-			}
-			nodes.push(node);
+			nodes.push(parseContextNode(rawContextItem));
 		}
 	}
 	return {
@@ -254,23 +256,15 @@ function collectHierarchyEntries(hierarchy, categories) {
 		if (category == null || !(categories == null || categories.includes(category))) continue;
 		if (!Array.isArray(values)) continue;
 		for (const value of values) {
-			if (category === "resource" && isResourceWrapper(value)) {
-				for (const resource of value.resource) {
-					entries.push({
-						category,
-						item: resource,
-						fallbackIndex
-					});
-					fallbackIndex += 1;
-				}
-				continue;
+			const items = category === "resource" && isResourceWrapper(value) ? value.resource : [value];
+			for (const item of items) {
+				entries.push({
+					category,
+					item,
+					fallbackIndex
+				});
+				fallbackIndex += 1;
 			}
-			entries.push({
-				category,
-				item: value,
-				fallbackIndex
-			});
-			fallbackIndex += 1;
 		}
 	}
 	entries.sort(sourceOrderSort);
@@ -1169,7 +1163,7 @@ function parseMetadataLanguages(rawOchre) {
 	return languages.length > 0 ? languages : [...DEFAULT_LANGUAGES];
 }
 function resolveLanguages(requestedLanguages, metadataLanguages) {
-	if (requestedLanguages.length === 0) return metadataLanguages;
+	if (requestedLanguages == null || requestedLanguages.length === 0) return metadataLanguages;
 	const unsupportedLanguages = [];
 	for (const requestedLanguage of requestedLanguages) if (!metadataLanguages.some((metadataLanguage) => metadataLanguage.toLocaleLowerCase("en-US") === requestedLanguage.toLocaleLowerCase("en-US"))) unsupportedLanguages.push(requestedLanguage);
 	if (unsupportedLanguages.length > 0) throw new Error(`The following language(s) are not supported by the dataset: ${unsupportedLanguages.toSorted((a, b) => a.localeCompare(b, "en-US")).join(", ")}. Available languages: ${metadataLanguages.toSorted((a, b) => a.localeCompare(b, "en-US")).join(", ")}`, { cause: unsupportedLanguages });
@@ -1237,22 +1231,45 @@ function getSingleTopLevelRawItem(items, category) {
 	return items[0];
 }
 function parseTopLevelItem(rawOchre, category, options) {
+	const rawItems = rawOchre;
+	let parsedItem;
 	switch (category) {
-		case "tree": return parseTree(getSingleTopLevelRawItem("tree" in rawOchre ? rawOchre.tree : null, "tree"), {
-			...options,
-			containedItemCategory: normalizeTreeItemCategory(options.containedItemCategory)
-		});
-		case "bibliography": return parseBibliography(getSingleTopLevelRawItem("bibliography" in rawOchre ? rawOchre.bibliography : null, "bibliography"), options);
-		case "concept": return parseConcept(getSingleTopLevelRawItem("concept" in rawOchre ? rawOchre.concept : null, "concept"), options);
-		case "spatialUnit": return parseSpatialUnit(getSingleTopLevelRawItem("spatialUnit" in rawOchre ? rawOchre.spatialUnit : null, "spatial unit"), options);
-		case "period": return parsePeriod(getSingleTopLevelRawItem("period" in rawOchre ? rawOchre.period : null, "period"), options);
-		case "person": return parsePerson(getSingleTopLevelRawItem("person" in rawOchre ? rawOchre.person : null, "person"), options);
-		case "propertyVariable": return parsePropertyVariable(getSingleTopLevelRawItem("propertyVariable" in rawOchre ? rawOchre.propertyVariable : "variable" in rawOchre ? rawOchre.variable : null, "property variable"), options);
-		case "propertyValue": return parsePropertyValue(getSingleTopLevelRawItem("propertyValue" in rawOchre ? rawOchre.propertyValue : "value" in rawOchre ? rawOchre.value : null, "property value"), options);
-		case "resource": return parseResource(getSingleTopLevelRawItem("resource" in rawOchre ? rawOchre.resource : null, "resource"), options);
-		case "text": return parseText(getSingleTopLevelRawItem("text" in rawOchre ? rawOchre.text : null, "text"), options);
-		case "set": return parseSet(getSingleTopLevelRawItem("set" in rawOchre ? rawOchre.set : null, "set"), options);
+		case "tree":
+			parsedItem = parseTree(getSingleTopLevelRawItem(rawItems.tree, "tree"), {
+				...options,
+				containedItemCategory: normalizeTreeItemCategory(options.containedItemCategory)
+			});
+			break;
+		case "bibliography":
+			parsedItem = parseBibliography(getSingleTopLevelRawItem(rawItems.bibliography, "bibliography"), options);
+			break;
+		case "concept":
+			parsedItem = parseConcept(getSingleTopLevelRawItem(rawItems.concept, "concept"), options);
+			break;
+		case "spatialUnit":
+			parsedItem = parseSpatialUnit(getSingleTopLevelRawItem(rawItems.spatialUnit, "spatial unit"), options);
+			break;
+		case "period":
+			parsedItem = parsePeriod(getSingleTopLevelRawItem(rawItems.period, "period"), options);
+			break;
+		case "person":
+			parsedItem = parsePerson(getSingleTopLevelRawItem(rawItems.person, "person"), options);
+			break;
+		case "propertyVariable":
+			parsedItem = parsePropertyVariable(getSingleTopLevelRawItem(rawItems.propertyVariable ?? rawItems.variable, "property variable"), options);
+			break;
+		case "propertyValue":
+			parsedItem = parsePropertyValue(getSingleTopLevelRawItem(rawItems.propertyValue ?? rawItems.value, "property value"), options);
+			break;
+		case "resource":
+			parsedItem = parseResource(getSingleTopLevelRawItem(rawItems.resource, "resource"), options);
+			break;
+		case "text":
+			parsedItem = parseText(getSingleTopLevelRawItem(rawItems.text, "text"), options);
+			break;
+		case "set": parsedItem = parseSet(getSingleTopLevelRawItem(rawItems.set, "set"), options);
 	}
+	return parsedItem;
 }
 function parseLinkedItems(rawItems, options) {
 	const parserOptions = {

package/dist/parsers/mdx.d.mts

@@ -1,5 +1,4 @@
 //#region src/parsers/mdx.d.ts
-declare function serializeMDXText(value: string): string;
-declare function serializeMDXContent(value: string): string;
-//#endregion
-export { serializeMDXContent, serializeMDXText };
+export declare function serializeMDXText(value: string): string;
+export declare function serializeMDXContent(value: string): string;
+//#endregion