ochre-sdk 1.0.0-beta.6 → 1.0.0-beta.8

package/dist/index.d.mts

@@ -294,7 +294,7 @@ type Event<T extends ReadonlyArray<string>> = {
     end: Date;
   } | null;
   label: MultilingualString<T>;
-  comment: string | null;
+  comment: MultilingualString<T> | null;
   agent: {
     uuid: string;
     label: MultilingualString<T>;
@@ -402,7 +402,7 @@ type ImageMap = {
  */
 type Note<T extends ReadonlyArray<string>> = {
   number: number;
-  title: string | null;
+  title: MultilingualString<T> | null;
   content: MultilingualString<T>;
   authors: Array<Person<T, "nested">>;
 };
@@ -440,19 +440,34 @@ type PropertyValueContent<T extends ReadonlyArray<string>> = Prettify<{
  *  Property in OCHRE
  */
 type Property<T extends ReadonlyArray<string>> = {
-  label: {
+  variable: {
     uuid: string;
+    label: MultilingualString<T>;
     publicationDateTime: Date | null;
-    name: string;
   };
   values: Array<PropertyValueContent<T>>;
   comment: MultilingualString<T> | null;
   properties: Array<Property<T>>;
 };
+/**
+ * Simplified property in OCHRE website payloads. Simplified property variables
+ * expose scalar labels rather than multilingual labels.
+ */
+type SimplifiedProperty<T extends ReadonlyArray<string>> = {
+  variable: {
+    uuid: string;
+    label: string;
+    publicationDateTime: Date | null;
+  };
+  values: Array<PropertyValueContent<T>>;
+  comment: MultilingualString<T> | null;
+  properties: Array<SimplifiedProperty<T>>;
+};
 /**
  *  Property in a Set item. OCHRE exposes Set item properties as a flat list.
  */
 type SingleHierarchyProperty<T extends ReadonlyArray<string>> = Omit<Property<T>, "properties">;
+type SingleHierarchySimplifiedProperty<T extends ReadonlyArray<string>> = Omit<SimplifiedProperty<T>, "properties">;
 type WithSingleHierarchyProperties<U extends {
   properties: Array<Property<T>>;
 }, T extends ReadonlyArray<string>> = U extends {
@@ -828,7 +843,7 @@ type PropertyValueQueryItem = {
   count: number;
   dataType: Exclude<PropertyValueContent<ReadonlyArray<string>>["dataType"], "coordinate">;
   content: string | number | boolean | null;
-  label: string | null;
+  label: MultilingualString | null;
 };
 /**
  * Represents a grouped Set attribute value query item
@@ -1529,7 +1544,7 @@ type WebElementComponent<T extends ReadonlyArray<string> = ReadonlyArray<string>
   component: "query";
   linkUuids: Array<string>;
   items: Array<{
-    label: string;
+    label: MultilingualString<T>;
     queries: Array<WebsitePropertyQuery<T>>;
     startIcon: string | null;
     endIcon: string | null;
@@ -1561,7 +1576,7 @@ type WebElementComponent<T extends ReadonlyArray<string> = ReadonlyArray<string>
 } | {
   component: "search-bar";
   queryVariant: "submit" | "change";
-  placeholder: string | null;
+  placeholder: MultilingualString<T> | null;
   baseFilterQueries: string | null;
   boundElementUuid: string | null;
   href: string | null;
@@ -1680,127 +1695,146 @@ type PropertyOptions = {
   limitToLeafPropertyValues?: boolean;
 };
 type PropertyContent<T extends ReadonlyArray<string>> = PropertyValueContent<T>["content"];
+type SearchableProperty<T extends ReadonlyArray<string>> = Property<T> | SingleHierarchyProperty<T> | SimplifiedProperty<T> | SingleHierarchySimplifiedProperty<T>;
 /**
- * Finds a property by its label UUID in an array of properties.
+ * Finds a property by its variable UUID in an array of properties.
  *
  * @param properties - Array of properties to search through
- * @param labelUuid - The property label UUID to search for
+ * @param labelUuid - The property variable UUID to search for
  * @param options - Search options, including whether to include nested properties
  * @returns The matching Property object, or null if not found
  */
 declare function getPropertyByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelUuid: string, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchyProperty<T>>, labelUuid: string, options?: PropertyOptions): SingleHierarchyProperty<T> | null;
+declare function getPropertyByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SimplifiedProperty<T>>, labelUuid: string, options?: PropertyOptions): SimplifiedProperty<T> | null;
+declare function getPropertyByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchySimplifiedProperty<T>>, labelUuid: string, options?: PropertyOptions): SingleHierarchySimplifiedProperty<T> | null;
 /**
- * Retrieves all values for a property with the given label UUID.
+ * Retrieves all values for a property with the given variable UUID.
  *
  * @param properties - Array of properties to search through
- * @param labelUuid - The property label UUID to search for
+ * @param labelUuid - The property variable UUID to search for
  * @param options - Search options, including whether to include nested properties
  * @returns Array of property values, or null if property not found
  */
-declare function getPropertyValuesByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelUuid: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
+declare function getPropertyValuesByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SearchableProperty<T>>, labelUuid: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
 /**
- * Retrieves all value contents for a property with the given label UUID.
+ * Retrieves all value contents for a property with the given variable UUID.
  *
  * @param properties - Array of properties to search through
- * @param labelUuid - The property label UUID to search for
+ * @param labelUuid - The property variable UUID to search for
  * @param options - Search options, including whether to include nested properties
  * @returns Array of property value contents, or null if property not found
  */
-declare function getPropertyValueContentsByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelUuid: string, options?: PropertyOptions): Array<PropertyContent<T>> | null;
+declare function getPropertyValueContentsByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SearchableProperty<T>>, labelUuid: string, options?: PropertyOptions): Array<PropertyContent<T>> | null;
 /**
- * Gets the first value of a property with the given label UUID.
+ * Gets the first value of a property with the given variable UUID.
  *
  * @param properties - Array of properties to search through
- * @param labelUuid - The property label UUID to search for
+ * @param labelUuid - The property variable UUID to search for
  * @param options - Search options, including whether to include nested properties
  * @returns The first property value, or null if property not found
  */
-declare function getPropertyValueByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelUuid: string, options?: PropertyOptions): PropertyValueContent<T> | null;
+declare function getPropertyValueByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SearchableProperty<T>>, labelUuid: string, options?: PropertyOptions): PropertyValueContent<T> | null;
 /**
- * Gets the first value content of a property with the given label UUID.
+ * Gets the first value content of a property with the given variable UUID.
  *
  * @param properties - Array of properties to search through
- * @param labelUuid - The property label UUID to search for
+ * @param labelUuid - The property variable UUID to search for
  * @param options - Search options, including whether to include nested properties
  * @returns The first property value content, or null if property not found
  */
-declare function getPropertyValueContentByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelUuid: string, options?: PropertyOptions): PropertyContent<T> | null;
+declare function getPropertyValueContentByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SearchableProperty<T>>, labelUuid: string, options?: PropertyOptions): PropertyContent<T> | null;
 /**
- * Finds a property by its label name in an array of properties.
+ * Finds a property by its variable label name in an array of properties.
  *
  * @param properties - Array of properties to search through
- * @param labelName - The property label name to search for
+ * @param labelName - The property variable label name to search for
  * @param options - Search options, including whether to include nested properties
  * @returns The matching Property object, or null if not found
  */
 declare function getPropertyByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchyProperty<T>>, labelName: string, options?: PropertyOptions): SingleHierarchyProperty<T> | null;
+declare function getPropertyByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SimplifiedProperty<T>>, labelName: string, options?: PropertyOptions): SimplifiedProperty<T> | null;
+declare function getPropertyByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchySimplifiedProperty<T>>, labelName: string, options?: PropertyOptions): SingleHierarchySimplifiedProperty<T> | null;
 /**
- * Finds a property by its label name and all values.
+ * Finds a property by its variable label name and all values.
  *
  * @param properties - Array of properties to search through
- * @param labelName - The property label name to search for
+ * @param labelName - The property variable label name to search for
  * @param values - The property values to search for
  * @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 getPropertyByLabelNameAndValues<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelNameAndValues<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchyProperty<T>>, labelName: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): SingleHierarchyProperty<T> | null;
+declare function getPropertyByLabelNameAndValues<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SimplifiedProperty<T>>, labelName: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): SimplifiedProperty<T> | null;
+declare function getPropertyByLabelNameAndValues<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchySimplifiedProperty<T>>, labelName: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): SingleHierarchySimplifiedProperty<T> | null;
 /**
- * Finds a property by its label name and all value contents.
+ * Finds a property by its variable label name and all value contents.
  *
  * @param properties - Array of properties to search through
- * @param labelName - The property label name to search for
+ * @param labelName - The property variable label name to search for
  * @param valueContents - The value contents to search for
  * @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 getPropertyByLabelNameAndValueContents<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelNameAndValueContents<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchyProperty<T>>, labelName: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): SingleHierarchyProperty<T> | null;
+declare function getPropertyByLabelNameAndValueContents<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SimplifiedProperty<T>>, labelName: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): SimplifiedProperty<T> | null;
+declare function getPropertyByLabelNameAndValueContents<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchySimplifiedProperty<T>>, labelName: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): SingleHierarchySimplifiedProperty<T> | null;
 /**
- * Finds a property by its label name and one value.
+ * Finds a property by its variable label name and one value.
  *
  * @param properties - Array of properties to search through
- * @param labelName - The property label name to search for
+ * @param labelName - The property variable label name to search for
  * @param value - The property value to search for
  * @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 getPropertyByLabelNameAndValue<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, value: PropertyValueContent<T>, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelNameAndValue<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchyProperty<T>>, labelName: string, value: PropertyValueContent<T>, options?: PropertyOptions): SingleHierarchyProperty<T> | null;
+declare function getPropertyByLabelNameAndValue<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SimplifiedProperty<T>>, labelName: string, value: PropertyValueContent<T>, options?: PropertyOptions): SimplifiedProperty<T> | null;
+declare function getPropertyByLabelNameAndValue<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchySimplifiedProperty<T>>, labelName: string, value: PropertyValueContent<T>, options?: PropertyOptions): SingleHierarchySimplifiedProperty<T> | null;
 /**
- * Finds a property by its label name and one value content.
+ * Finds a property by its variable label name and one value content.
  *
  * @param properties - Array of properties to search through
- * @param labelName - The property label name to search for
+ * @param labelName - The property variable label name to search for
  * @param valueContent - The value content to search for
  * @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 getPropertyByLabelNameAndValueContent<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, valueContent: PropertyContent<T>, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelNameAndValueContent<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchyProperty<T>>, labelName: string, valueContent: PropertyContent<T>, options?: PropertyOptions): SingleHierarchyProperty<T> | null;
+declare function getPropertyByLabelNameAndValueContent<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SimplifiedProperty<T>>, labelName: string, valueContent: PropertyContent<T>, options?: PropertyOptions): SimplifiedProperty<T> | null;
+declare function getPropertyByLabelNameAndValueContent<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchySimplifiedProperty<T>>, labelName: string, valueContent: PropertyContent<T>, options?: PropertyOptions): SingleHierarchySimplifiedProperty<T> | null;
 /**
- * Retrieves all values for a property with the given label name.
+ * Retrieves all values for a property with the given variable label name.
  *
  * @param properties - Array of properties to search through
- * @param labelName - The property label name to search for
+ * @param labelName - The property variable label name to search for
  * @param options - Search options, including whether to include nested properties
  * @returns Array of property values, or null if property not found
  */
-declare function getPropertyValuesByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
+declare function getPropertyValuesByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SearchableProperty<T>>, labelName: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
 /**
- * Gets the first value of a property with the given label name.
+ * Gets the first value of a property with the given variable label name.
  *
  * @param properties - Array of properties to search through
- * @param labelName - The property label name to search for
+ * @param labelName - The property variable label name to search for
  * @param options - Search options, including whether to include nested properties
  * @returns The first property value, or null if property not found
  */
-declare function getPropertyValueByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, options?: PropertyOptions): PropertyValueContent<T> | null;
+declare function getPropertyValueByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SearchableProperty<T>>, labelName: string, options?: PropertyOptions): PropertyValueContent<T> | null;
 /**
- * Gets the first value content of a property with the given label name.
+ * Gets the first value content of a property with the given variable label name.
  *
  * @param properties - Array of properties to search through
- * @param labelName - The property label name to search for
+ * @param labelName - The property variable label name to search for
  * @param options - Search options, including whether to include nested properties
  * @returns The first property value content, or null if property not found
  */
-declare function getPropertyValueContentByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, options?: PropertyOptions): PropertyContent<T> | null;
+declare function getPropertyValueContentByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SearchableProperty<T>>, labelName: string, options?: PropertyOptions): PropertyContent<T> | null;
 /**
  * Gets all unique properties from an array of properties.
  *
@@ -1809,14 +1843,17 @@ declare function getPropertyValueContentByLabelName<T extends ReadonlyArray<stri
  * @returns Array of unique properties
  */
 declare function getUniqueProperties<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, options?: PropertyOptions): Array<Property<T>>;
+declare function getUniqueProperties<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchyProperty<T>>, options?: PropertyOptions): Array<SingleHierarchyProperty<T>>;
+declare function getUniqueProperties<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SimplifiedProperty<T>>, options?: PropertyOptions): Array<SimplifiedProperty<T>>;
+declare function getUniqueProperties<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SingleHierarchySimplifiedProperty<T>>, options?: PropertyOptions): Array<SingleHierarchySimplifiedProperty<T>>;
 /**
- * Gets all unique property label names from an array of properties.
+ * Gets all unique property variable label names from an array of properties.
  *
- * @param properties - Array of properties to get unique property labels from
+ * @param properties - Array of properties to get unique property variable labels from
  * @param options - Search options, including whether to include nested properties
- * @returns Array of unique property label names
+ * @returns Array of unique property variable label names
  */
-declare function getUniquePropertyLabelNames<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, options?: PropertyOptions): Array<string>;
+declare function getUniquePropertyLabelNames<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<SearchableProperty<T>>, options?: PropertyOptions): Array<string>;
 /**
  * Get the leaf property values from an array of property values.
  *
@@ -1825,16 +1862,16 @@ declare function getUniquePropertyLabelNames<T extends ReadonlyArray<string> = R
  */
 declare function getLeafPropertyValues<T extends ReadonlyArray<string> = ReadonlyArray<string>>(propertyValues: ReadonlyArray<PropertyValueContent<T>>): Array<PropertyValueContent<T>>;
 /**
- * Filters a property based on a label and value criterion.
+ * Filters a property based on a variable label and value criterion.
  *
  * @param property - The property to filter
- * @param filter - Filter criteria containing label and value to match
- * @param filter.labelName - The label name to filter by
+ * @param filter - Filter criteria containing variable label and value to match
+ * @param filter.labelName - The variable label name to filter by
  * @param filter.value - The value to filter by
  * @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 ReadonlyArray<string> = ReadonlyArray<string>>(property: Property<T>, filter: {
+declare function filterProperties<T extends ReadonlyArray<string> = ReadonlyArray<string>>(property: SearchableProperty<T>, filter: {
   labelName: string;
   value: PropertyValueContent<T>;
 }, options?: PropertyOptions): boolean;
@@ -1854,4 +1891,4 @@ declare const DEFAULT_PAGE_SIZE = 48;
  */
 declare function flattenItemProperties<U extends DataCategory = DataCategory, V extends HierarchyItemDataCategory<U> = HierarchyItemDataCategory<U>, T extends ReadonlyArray<string> = ReadonlyArray<string>, W extends ItemLocation = "topLevel">(item: Item<U, V, T, W>): FlattenedItem<Item<U, V, T, W>, T>;
 //#endregion
-export { BaseItem, BaseItemLink, BelongsTo, Bibliography, BibliographyEntryInfo, BibliographyItemLink, BibliographySourceDocument, Concept, ConceptItemLink, Context, ContextDataCategory, ContextItem, ContextNode, ContextTree, ContextTreeFilterLevel, ContextTreeLevel, ContextTreeLevelItem, Coordinates, CoordinatesSource, DEFAULT_PAGE_SIZE, DataCategory, DictionaryUnitItemLink, Event, Gallery, Heading, HeadingDataCategory, HierarchyDataCategory, HierarchyItemCategoryFromOption, HierarchyItemCategoryOption, HierarchyItemDataCategory, Identification, Image, ImageMap, ImageMapArea, Interpretation, Item, ItemLink, ItemLinkCategory, ItemLinks, ItemLocation, ItemsDataCategory, License, Metadata, type MultilingualOptions, MultilingualString, type MultilingualStringEntry, type MultilingualStringInput, type MultilingualStringJSON, type MultilingualStringText, Note, Observation, Period, PeriodItemLink, Person, PersonItemLink, Property, PropertyOptions, PropertyValue, PropertyValueContent, PropertyValueItemLink, PropertyValueQueryItem, PropertyVariable, PropertyVariableItemLink, Query, QueryGroup, QueryLeaf, RecursiveDataCategory, Resource, ResourceItemLink, Scope, Section, Set, SetAttributeValueQueryItem, SetBibliography, SetConcept, SetItem, SetItemDataCategory, SetItemLink, SetItemsSort, SetItemsSortDirection, SetPeriod, SetResource, SetSpatialUnit, SetTree, SingleHierarchyProperty, SpatialUnit, SpatialUnitItemLink, Style, StylesheetCategory, StylesheetItem, Text, TextItemLink, Tree, TreeItemLink, WebBlock, WebBlockLayout, WebElement, WebElementComponent, WebImage, WebSegment, WebSegmentItem, WebTitle, Webpage, Website, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteType, defineLanguages, fetchGallery, fetchItem, fetchItemLinks, fetchSetItems, fetchSetPropertyValues, fetchWebsite, filterProperties, flattenItemProperties, getLeafPropertyValues, getPropertyByLabelName, getPropertyByLabelNameAndValue, getPropertyByLabelNameAndValueContent, getPropertyByLabelNameAndValueContents, getPropertyByLabelNameAndValues, getPropertyByLabelUuid, getPropertyValueByLabelName, getPropertyValueByLabelUuid, getPropertyValueContentByLabelName, getPropertyValueContentByLabelUuid, getPropertyValueContentsByLabelUuid, getPropertyValuesByLabelName, getPropertyValuesByLabelUuid, getUniqueProperties, getUniquePropertyLabelNames, withLanguages };
+export { BaseItem, BaseItemLink, BelongsTo, Bibliography, BibliographyEntryInfo, BibliographyItemLink, BibliographySourceDocument, Concept, ConceptItemLink, Context, ContextDataCategory, ContextItem, ContextNode, ContextTree, ContextTreeFilterLevel, ContextTreeLevel, ContextTreeLevelItem, Coordinates, CoordinatesSource, DEFAULT_PAGE_SIZE, DataCategory, DictionaryUnitItemLink, Event, Gallery, Heading, HeadingDataCategory, HierarchyDataCategory, HierarchyItemCategoryFromOption, HierarchyItemCategoryOption, HierarchyItemDataCategory, Identification, Image, ImageMap, ImageMapArea, Interpretation, Item, ItemLink, ItemLinkCategory, ItemLinks, ItemLocation, ItemsDataCategory, License, Metadata, type MultilingualOptions, MultilingualString, type MultilingualStringEntry, type MultilingualStringInput, type MultilingualStringJSON, type MultilingualStringText, Note, Observation, Period, PeriodItemLink, Person, PersonItemLink, Property, PropertyOptions, PropertyValue, PropertyValueContent, PropertyValueItemLink, PropertyValueQueryItem, PropertyVariable, PropertyVariableItemLink, Query, QueryGroup, QueryLeaf, RecursiveDataCategory, Resource, ResourceItemLink, Scope, Section, Set, SetAttributeValueQueryItem, SetBibliography, SetConcept, SetItem, SetItemDataCategory, SetItemLink, SetItemsSort, SetItemsSortDirection, SetPeriod, SetResource, SetSpatialUnit, SetTree, SimplifiedProperty, SingleHierarchyProperty, SingleHierarchySimplifiedProperty, SpatialUnit, SpatialUnitItemLink, Style, StylesheetCategory, StylesheetItem, Text, TextItemLink, Tree, TreeItemLink, WebBlock, WebBlockLayout, WebElement, WebElementComponent, WebImage, WebSegment, WebSegmentItem, WebTitle, Webpage, Website, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteType, defineLanguages, fetchGallery, fetchItem, fetchItemLinks, fetchSetItems, fetchSetPropertyValues, fetchWebsite, filterProperties, flattenItemProperties, getLeafPropertyValues, getPropertyByLabelName, getPropertyByLabelNameAndValue, getPropertyByLabelNameAndValueContent, getPropertyByLabelNameAndValueContents, getPropertyByLabelNameAndValues, getPropertyByLabelUuid, getPropertyValueByLabelName, getPropertyValueByLabelUuid, getPropertyValueContentByLabelName, getPropertyValueContentByLabelUuid, getPropertyValueContentsByLabelUuid, getPropertyValuesByLabelName, getPropertyValuesByLabelUuid, getUniqueProperties, getUniquePropertyLabelNames, withLanguages };

package/dist/index.mjs

@@ -510,7 +510,7 @@ function flattenProperties(properties) {
 	const result = [];
 	for (const property of properties) {
 		result.push({
-			label: property.label,
+			variable: property.variable,
 			values: property.values,
 			comment: property.comment
 		});
@@ -1448,7 +1448,7 @@ function parseEvent(rawEvent, options) {
 			end: endDate
 		},
 		label: parseRequiredContentLike(rawEvent.label, options),
-		comment: parseContentLike(rawEvent.comment, options)?.getText() ?? null,
+		comment: parseContentLike(rawEvent.comment, options),
 		agent: parseEventReference(rawEvent.agent, options),
 		location: parseEventReference(rawEvent.location, options),
 		other: rawEvent.other == null ? null : {
@@ -1655,21 +1655,25 @@ function parseImageMap(rawImageMap) {
 function parseNote(rawNote, options) {
 	const authors = [];
 	for (const author of rawNote.authors?.author ?? []) authors.push(parsePerson(author, options));
-	let title = rawNote.title ?? null;
-	if (title == null) {
-		for (const content of rawNote.content ?? []) if (options.languages.includes(content.lang) && content.title != null) {
-			title = content.title;
-			break;
-		}
-	}
 	const content = rawNote.content == null ? multilingualFromText(parseXMLString(rawNote, { parseEmail: true }), options) : parseRequiredContentLike(rawNote, options);
 	return {
 		number: rawNote.noteNo ?? 0,
-		title,
+		title: parseNoteTitle(rawNote, options),
 		content,
 		authors
 	};
 }
+function parseNoteTitle(rawNote, options) {
+	if (rawNote.title != null) return multilingualFromText(rawNote.title, options);
+	const titleContent = {};
+	for (const content of rawNote.content ?? []) {
+		if (!options.languages.includes(content.lang) || content.title == null) continue;
+		titleContent[content.lang] = content.title;
+	}
+	if (Object.keys(titleContent).length > 0) return MultilingualString.fromObject(titleContent, options.languages);
+	for (const content of rawNote.content ?? []) if (content.lang !== "zxx" && content.title != null) return multilingualFromText(content.title, options);
+	return null;
+}
 function parseNotes(rawNotes, options) {
 	const notes = [];
 	for (const note of rawNotes?.note ?? []) notes.push(parseNote(note, options));
@@ -1736,10 +1740,10 @@ function parseProperty(rawProperty, options) {
 	const properties = [];
 	for (const property of rawProperty.property ?? []) properties.push(parseProperty(property, options));
 	return {
-		label: {
+		variable: {
 			uuid: rawProperty.label.uuid,
-			publicationDateTime: rawProperty.label.publicationDateTime ?? null,
-			name: parseContentLikeText(rawProperty.label, options)
+			label: parseRequiredContentLike(rawProperty.label, options),
+			publicationDateTime: rawProperty.label.publicationDateTime ?? null
 		},
 		values,
 		comment: parseContentLike(rawProperty.comment, options),
@@ -1751,10 +1755,31 @@ function parseProperties(rawProperties, options) {
 	for (const property of rawProperties?.property ?? []) properties.push(parseProperty(property, options));
 	return properties;
 }
+function parseSimplifiedProperty(rawProperty, options) {
+	const values = [];
+	for (const value of rawProperty.value ?? []) values.push(parsePropertyValueContent(value, options));
+	const properties = [];
+	for (const property of rawProperty.property ?? []) properties.push(parseSimplifiedProperty(property, options));
+	return {
+		variable: {
+			uuid: rawProperty.label.uuid,
+			label: parseContentLikeText(rawProperty.label, options),
+			publicationDateTime: rawProperty.label.publicationDateTime ?? null
+		},
+		values,
+		comment: parseContentLike(rawProperty.comment, options),
+		properties
+	};
+}
+function parseSimplifiedProperties(rawProperties, options) {
+	const properties = [];
+	for (const property of rawProperties?.property ?? []) properties.push(parseSimplifiedProperty(property, options));
+	return properties;
+}
 function parseSingleHierarchyProperty(rawProperty, options) {
 	const property = parseProperty(rawProperty, options);
 	return {
-		label: property.label,
+		variable: property.variable,
 		values: property.values,
 		comment: property.comment
 	};
@@ -4698,9 +4723,20 @@ async function fetchSetItems(params, itemCategories, options) {
 }
 //#endregion
 //#region src/fetchers/set/property-values.ts
-function parsePropertyValueLabel(content) {
-	if (content == null || content === "") return null;
-	return content === "<unassigned>" ? null : content;
+function getLabelContentLanguages(content) {
+	const languages = [];
+	for (const contentItem of content) if (contentItem.lang !== "zxx" && !languages.includes(contentItem.lang)) languages.push(contentItem.lang);
+	return languages.length > 0 ? languages : [...DEFAULT_LANGUAGES];
+}
+function parsePropertyValueLabelText(text) {
+	if (text == null || text === "") return null;
+	return text === "<unassigned>" ? null : text;
+}
+function parsePropertyValueLabel(content, text) {
+	if (content != null && content.length > 0) return parseXMLContent({ content }, { languages: getLabelContentLanguages(content) });
+	const parsedText = parsePropertyValueLabelText(text);
+	if (parsedText == null) return null;
+	return MultilingualString.fromObject({ [DEFAULT_LANGUAGES[0]]: parsedText });
 }
 function parsePropertyValueBooleanContent(rawValue) {
 	if (rawValue == null || rawValue === "") return null;
@@ -4723,7 +4759,9 @@ function normalizePropertyValueDataType(dataType) {
 function sortPropertyValues(values) {
 	return values.toSorted((a, b) => {
 		if (a.count !== b.count) return b.count - a.count;
-		if (a.label !== b.label) return a.label?.localeCompare(b.label ?? "") ?? 0;
+		const label = a.label?.getText() ?? null;
+		const otherLabel = b.label?.getText() ?? null;
+		if (label !== otherLabel) return label?.localeCompare(otherLabel ?? "") ?? 0;
 		return a.content?.toString().localeCompare(b.content?.toString() ?? "") ?? 0;
 	});
 }
@@ -4741,6 +4779,11 @@ const countSchema = v.pipe(v.optional(v.union([v.number(), v.string()]), 1), v.t
 	const count = Number(val);
 	return Number.isFinite(count) ? count : 1;
 }));
+const propertyValueLabelStringSchema = v.object({ payload: v.optional(v.string(), "") });
+const propertyValueLabelContentSchema = v.object({
+	lang: v.string(),
+	string: v.array(propertyValueLabelStringSchema)
+});
 function getPropertyVariableUuidsFromQueries(queries) {
 	const propertyVariableUuids = /* @__PURE__ */ new Set();
 	if (queries == null) return [];
@@ -4783,10 +4826,11 @@ const propertyValueQueryItemSchema = v.pipe(v.object({
 	globalCount: v.nullish(countSchema),
 	dataType: v.optional(v.string(), "string"),
 	rawValue: v.optional(v.string()),
-	payload: v.optional(v.string())
+	payload: v.optional(v.string()),
+	content: v.optional(v.array(propertyValueLabelContentSchema))
 }), v.transform((val) => {
 	const dataType = normalizePropertyValueDataType(val.dataType);
-	const label = parsePropertyValueLabel(val.payload);
+	const label = parsePropertyValueLabel(val.content, val.payload);
 	const returnValue = {
 		scope: val.scope,
 		variableUuid: val.variableUuid != null && val.variableUuid !== "" ? val.variableUuid : null,
@@ -4811,9 +4855,11 @@ const propertyValueQueryItemSchema = v.pipe(v.object({
 		case "boolean":
 			returnValue.content = parsePropertyValueBooleanContent(val.rawValue);
 			break;
-		default:
-			returnValue.content = val.rawValue != null && val.rawValue !== "" ? val.rawValue.toString() : label ?? null;
+		default: {
+			const labelText = label?.getText() ?? null;
+			returnValue.content = val.rawValue != null && val.rawValue !== "" ? val.rawValue.toString() : labelText;
 			break;
+		}
 	}
 	return returnValue;
 }));
@@ -4874,12 +4920,20 @@ function buildXQuery(params) {
   )
 };
 
-declare function local:value-display($v) {
+declare function local:value-display-text($v) {
   if ($v/content)
   then string-join($v/content[@xml:lang="eng"]//text(), "")
   else string($v)
 };
 
+declare function local:value-label-content($v) {
+  if ($v/content) then
+    for $content in $v/content
+    let $lang := string($content/@xml:lang)
+    return <content lang="{$lang}"><string>{string-join($content//text(), "")}</string></content>
+  else ()
+};
+
 declare function local:value-content($data-type, $raw-value, $value-uuid, $display) {
   if ($data-type = "IDREF") then $value-uuid
   else if ($data-type = ("integer", "decimal", "time")) then
@@ -4914,7 +4968,8 @@ declare function local:put-property-detail(
   $value-uuid,
   $raw-value,
   $data-type,
-  $display
+  $display,
+  $label-content
 ) {
   let $existing := map:get($details, $key)
   return
@@ -4925,7 +4980,7 @@ declare function local:put-property-detail(
       map:put(
         $details,
         $key,
-        <propertyValue scope="{$scope}" variableUuid="{$variable-uuid}" uuid="{$value-uuid}" rawValue="{$raw-value}" dataType="{$data-type}">{$display}</propertyValue>
+        <propertyValue scope="{$scope}" variableUuid="{$variable-uuid}" uuid="{$value-uuid}" rawValue="{$raw-value}" dataType="{$data-type}">{$label-content}{$display}</propertyValue>
       )
     else ()
 };
@@ -4940,13 +4995,14 @@ declare function local:add-property-facet(
   $value-uuid,
   $raw-value,
   $data-type,
-  $display
+  $display,
+  $label-content
 ) {
   if (exists(map:get($seen, $key))) then ()
   else (
     map:put($seen, $key, true()),
     local:increment-count($counts, $key),
-    local:put-property-detail($details, $key, $scope, $variable-uuid, $value-uuid, $raw-value, $data-type, $display)
+    local:put-property-detail($details, $key, $scope, $variable-uuid, $value-uuid, $raw-value, $data-type, $display, $label-content)
   )
 };
 
@@ -4977,7 +5033,8 @@ let $_property-aggregation := xdmp:eager(
     let $value-uuid := string($v/@uuid)
     let $raw-value := string($v/@rawValue)
     let $data-type := string($v/@dataType)
-    let $display := local:value-display($v)
+    let $display := local:value-display-text($v)
+    let $label-content := local:value-label-content($v)
     let $content := local:value-content($data-type, $raw-value, $value-uuid, $display)
     let $value-kind := local:value-kind($data-type)
     let $output-raw-value := local:property-output-raw-value($data-type, $raw-value, $content)
@@ -4986,7 +5043,7 @@ let $_property-aggregation := xdmp:eager(
     where $content != ""
     return (
       local:add-attribute-facet($global-property-counts, $global-seen, $global-key),
-      local:add-property-facet($variable-property-counts, $variable-property-details, $variable-seen, $variable-key, "variable", $variable-uuid, $value-uuid, $output-raw-value, $data-type, $display),
+      local:add-property-facet($variable-property-counts, $variable-property-details, $variable-seen, $variable-key, "variable", $variable-uuid, $value-uuid, $output-raw-value, $data-type, $display, $label-content),
       map:put($variable-property-global-keys, $variable-key, $global-key)
     )
 )
@@ -5176,14 +5233,17 @@ function withDefaultOptions(options) {
 		limitToLeafPropertyValues: options.limitToLeafPropertyValues ?? true
 	};
 }
-function findPropertyByLabelUuid(properties, labelUuid) {
-	for (const property of properties) if (property.label.uuid === labelUuid) return property;
+function findPropertyByVariableUuid(properties, labelUuid) {
+	for (const property of properties) if (property.variable.uuid === labelUuid) return property;
 	return null;
 }
-function findPropertyByLabelName(properties, labelName) {
-	for (const property of properties) if (property.label.name === labelName) return property;
+function findPropertyByVariableLabelName(properties, labelName) {
+	for (const property of properties) if (getPropertyVariableLabelName(property) === labelName) return property;
 	return null;
 }
+function getPropertyVariableLabelName(property) {
+	return typeof property.variable.label === "string" ? property.variable.label : property.variable.label.getText();
+}
 function propertyHasValue(property, value) {
 	for (const candidateValue of property.values) if (deepEqual(candidateValue, value)) return true;
 	return false;
@@ -5201,6 +5261,7 @@ function searchPropertyResult(properties, options, findDirectResult, transformNe
 	const directResult = findDirectResult(properties);
 	if (directResult !== null) return directResult;
 	if (options.includeNestedProperties) 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;
@@ -5263,49 +5324,41 @@ function getFirstPropertyValueContentResult(values, limitToLeafPropertyValues) {
 function visitProperties(properties, includeNestedProperties, visit) {
 	for (const property of properties) {
 		visit(property);
-		if (includeNestedProperties) visitProperties(property.properties, includeNestedProperties, visit);
+		if (includeNestedProperties && "properties" in property) visitProperties(property.properties, includeNestedProperties, visit);
 	}
 }
-/**
-* Finds a property by its label UUID in an array of properties.
-*
-* @param properties - Array of properties to search through
-* @param labelUuid - The property label UUID to search for
-* @param options - Search options, including whether to include nested properties
-* @returns The matching Property object, or null if not found
-*/
 function getPropertyByLabelUuid(properties, labelUuid, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties } = withDefaultOptions(options);
-	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => findPropertyByLabelUuid(currentProperties, labelUuid));
+	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => findPropertyByVariableUuid(currentProperties, labelUuid));
 }
 /**
-* Retrieves all values for a property with the given label UUID.
+* Retrieves all values for a property with the given variable UUID.
 *
 * @param properties - Array of properties to search through
-* @param labelUuid - The property label UUID to search for
+* @param labelUuid - The property variable UUID to search for
 * @param options - Search options, including whether to include nested properties
 * @returns Array of property values, or null if property not found
 */
 function getPropertyValuesByLabelUuid(properties, labelUuid, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties, limitToLeafPropertyValues } = withDefaultOptions(options);
 	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => {
-		const property = findPropertyByLabelUuid(currentProperties, labelUuid);
+		const property = findPropertyByVariableUuid(currentProperties, labelUuid);
 		if (property == null) return null;
 		return getPropertyValuesResult(property.values, limitToLeafPropertyValues, true);
 	}, (nestedResult) => getPropertyValuesResult(nestedResult, limitToLeafPropertyValues, true));
 }
 /**
-* Retrieves all value contents for a property with the given label UUID.
+* Retrieves all value contents for a property with the given variable UUID.
 *
 * @param properties - Array of properties to search through
-* @param labelUuid - The property label UUID to search for
+* @param labelUuid - The property variable UUID to search for
 * @param options - Search options, including whether to include nested properties
 * @returns Array of property value contents, or null if property not found
 */
 function getPropertyValueContentsByLabelUuid(properties, labelUuid, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties, limitToLeafPropertyValues } = withDefaultOptions(options);
 	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => {
-		const property = findPropertyByLabelUuid(currentProperties, labelUuid);
+		const property = findPropertyByVariableUuid(currentProperties, labelUuid);
 		if (property == null) return null;
 		const valueContents = [];
 		for (const value of getPropertyValuesResult(property.values, limitToLeafPropertyValues, false)) valueContents.push(value.content);
@@ -5313,10 +5366,10 @@ function getPropertyValueContentsByLabelUuid(properties, labelUuid, options = DE
 	});
 }
 /**
-* Gets the first value of a property with the given label UUID.
+* Gets the first value of a property with the given variable UUID.
 *
 * @param properties - Array of properties to search through
-* @param labelUuid - The property label UUID to search for
+* @param labelUuid - The property variable UUID to search for
 * @param options - Search options, including whether to include nested properties
 * @returns The first property value, or null if property not found
 */
@@ -5332,10 +5385,10 @@ function getPropertyValueByLabelUuid(properties, labelUuid, options = DEFAULT_OP
 	}, (nestedResult) => getFirstPropertyValueResult([nestedResult], limitToLeafPropertyValues));
 }
 /**
-* Gets the first value content of a property with the given label UUID.
+* Gets the first value content of a property with the given variable UUID.
 *
 * @param properties - Array of properties to search through
-* @param labelUuid - The property label UUID to search for
+* @param labelUuid - The property variable UUID to search for
 * @param options - Search options, including whether to include nested properties
 * @returns The first property value content, or null if property not found
 */
@@ -5350,103 +5403,59 @@ function getPropertyValueContentByLabelUuid(properties, labelUuid, options = DEF
 		return getFirstPropertyValueContentResult(values, limitToLeafPropertyValues);
 	});
 }
-/**
-* Finds a property by its label name in an array of properties.
-*
-* @param properties - Array of properties to search through
-* @param labelName - The property label name to search for
-* @param options - Search options, including whether to include nested properties
-* @returns The matching Property object, or null if not found
-*/
 function getPropertyByLabelName(properties, labelName, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties } = withDefaultOptions(options);
-	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => findPropertyByLabelName(currentProperties, labelName));
+	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => findPropertyByVariableLabelName(currentProperties, labelName));
 }
-/**
-* Finds a property by its label name and all values.
-*
-* @param properties - Array of properties to search through
-* @param labelName - The property label name to search for
-* @param values - The property values to search for
-* @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
-*/
 function getPropertyByLabelNameAndValues(properties, labelName, values, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties, limitToLeafPropertyValues } = withDefaultOptions(options);
 	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => {
-		for (const property of currentProperties) if (property.label.name === labelName && deepEqual(property.values, values)) return getNormalizedProperty(property, limitToLeafPropertyValues);
+		for (const property of currentProperties) if (getPropertyVariableLabelName(property) === labelName && deepEqual(property.values, values)) return getNormalizedProperty(property, limitToLeafPropertyValues);
 		return null;
 	}, (nestedResult) => getNormalizedProperty(nestedResult, limitToLeafPropertyValues));
 }
-/**
-* Finds a property by its label name and all value contents.
-*
-* @param properties - Array of properties to search through
-* @param labelName - The property label name to search for
-* @param valueContents - The value contents to search for
-* @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
-*/
 function getPropertyByLabelNameAndValueContents(properties, labelName, valueContents, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties, limitToLeafPropertyValues } = withDefaultOptions(options);
 	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => {
-		for (const property of currentProperties) if (property.label.name === labelName && propertyValueContentsEqual(property, valueContents)) return getNormalizedProperty(property, limitToLeafPropertyValues, clonePropertyValues);
+		for (const property of currentProperties) if (getPropertyVariableLabelName(property) === labelName && propertyValueContentsEqual(property, valueContents)) return getNormalizedProperty(property, limitToLeafPropertyValues, clonePropertyValues);
 		return null;
 	}, (nestedResult) => getNormalizedProperty(nestedResult, limitToLeafPropertyValues));
 }
-/**
-* Finds a property by its label name and one value.
-*
-* @param properties - Array of properties to search through
-* @param labelName - The property label name to search for
-* @param value - The property value to search for
-* @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
-*/
 function getPropertyByLabelNameAndValue(properties, labelName, value, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties, limitToLeafPropertyValues } = withDefaultOptions(options);
 	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => {
-		for (const property of currentProperties) if (property.label.name === labelName && propertyHasValue(property, value)) return getNormalizedProperty(property, limitToLeafPropertyValues);
+		for (const property of currentProperties) if (getPropertyVariableLabelName(property) === labelName && propertyHasValue(property, value)) return getNormalizedProperty(property, limitToLeafPropertyValues);
 		return null;
 	}, (nestedResult) => getNormalizedProperty(nestedResult, limitToLeafPropertyValues));
 }
-/**
-* Finds a property by its label name and one value content.
-*
-* @param properties - Array of properties to search through
-* @param labelName - The property label name to search for
-* @param valueContent - The value content to search for
-* @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
-*/
 function getPropertyByLabelNameAndValueContent(properties, labelName, valueContent, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties, limitToLeafPropertyValues } = withDefaultOptions(options);
 	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => {
-		for (const property of currentProperties) if (property.label.name === labelName && propertyHasValueContent(property, valueContent)) return getNormalizedProperty(property, limitToLeafPropertyValues);
+		for (const property of currentProperties) if (getPropertyVariableLabelName(property) === labelName && propertyHasValueContent(property, valueContent)) return getNormalizedProperty(property, limitToLeafPropertyValues);
 		return null;
 	}, (nestedResult) => getNormalizedProperty(nestedResult, limitToLeafPropertyValues));
 }
 /**
-* Retrieves all values for a property with the given label name.
+* Retrieves all values for a property with the given variable label name.
 *
 * @param properties - Array of properties to search through
-* @param labelName - The property label name to search for
+* @param labelName - The property variable label name to search for
 * @param options - Search options, including whether to include nested properties
 * @returns Array of property values, or null if property not found
 */
 function getPropertyValuesByLabelName(properties, labelName, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties, limitToLeafPropertyValues } = withDefaultOptions(options);
 	return searchPropertyResult(properties, { includeNestedProperties }, (currentProperties) => {
-		const property = findPropertyByLabelName(currentProperties, labelName);
+		const property = findPropertyByVariableLabelName(currentProperties, labelName);
 		if (property == null) return null;
 		return getPropertyValuesResult(property.values, limitToLeafPropertyValues, false);
 	}, (nestedResult) => getPropertyValuesResult(nestedResult, limitToLeafPropertyValues, false));
 }
 /**
-* Gets the first value of a property with the given label name.
+* Gets the first value of a property with the given variable label name.
 *
 * @param properties - Array of properties to search through
-* @param labelName - The property label name to search for
+* @param labelName - The property variable label name to search for
 * @param options - Search options, including whether to include nested properties
 * @returns The first property value, or null if property not found
 */
@@ -5462,10 +5471,10 @@ function getPropertyValueByLabelName(properties, labelName, options = DEFAULT_OP
 	}, (nestedResult) => getFirstPropertyValueResult([nestedResult], limitToLeafPropertyValues));
 }
 /**
-* Gets the first value content of a property with the given label name.
+* Gets the first value content of a property with the given variable label name.
 *
 * @param properties - Array of properties to search through
-* @param labelName - The property label name to search for
+* @param labelName - The property variable label name to search for
 * @param options - Search options, including whether to include nested properties
 * @returns The first property value content, or null if property not found
 */
@@ -5480,18 +5489,11 @@ function getPropertyValueContentByLabelName(properties, labelName, options = DEF
 		return getFirstPropertyValueContentResult(values, limitToLeafPropertyValues);
 	});
 }
-/**
-* Gets all unique properties from an array of properties.
-*
-* @param properties - Array of properties to get unique properties from
-* @param options - Search options, including whether to include nested properties
-* @returns Array of unique properties
-*/
 function getUniqueProperties(properties, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties, limitToLeafPropertyValues } = withDefaultOptions(options);
 	const uniqueProperties = [];
 	visitProperties(properties, includeNestedProperties, (property) => {
-		for (const uniqueProperty of uniqueProperties) if (uniqueProperty.label.uuid === property.label.uuid) return;
+		for (const uniqueProperty of uniqueProperties) if (uniqueProperty.variable.uuid === property.variable.uuid) return;
 		uniqueProperties.push(property);
 	});
 	if (limitToLeafPropertyValues) {
@@ -5502,18 +5504,19 @@ function getUniqueProperties(properties, options = DEFAULT_OPTIONS) {
 	return uniqueProperties;
 }
 /**
-* Gets all unique property label names from an array of properties.
+* Gets all unique property variable label names from an array of properties.
 *
-* @param properties - Array of properties to get unique property labels from
+* @param properties - Array of properties to get unique property variable labels from
 * @param options - Search options, including whether to include nested properties
-* @returns Array of unique property label names
+* @returns Array of unique property variable label names
 */
 function getUniquePropertyLabelNames(properties, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties } = withDefaultOptions(options);
 	const uniquePropertyLabels = [];
 	visitProperties(properties, includeNestedProperties, (property) => {
-		if (uniquePropertyLabels.includes(property.label.name)) return;
-		uniquePropertyLabels.push(property.label.name);
+		const labelName = getPropertyVariableLabelName(property);
+		if (uniquePropertyLabels.includes(labelName)) return;
+		uniquePropertyLabels.push(labelName);
 	});
 	return uniquePropertyLabels;
 }
@@ -5534,22 +5537,22 @@ function contentMatchesFilter(content, filterContent) {
 	return typeof filterContent === "boolean" && content === filterContent;
 }
 /**
-* Filters a property based on a label and value criterion.
+* Filters a property based on a variable label and value criterion.
 *
 * @param property - The property to filter
-* @param filter - Filter criteria containing label and value to match
-* @param filter.labelName - The label name to filter by
+* @param filter - Filter criteria containing variable label and value to match
+* @param filter.labelName - The variable label name to filter by
 * @param filter.value - The value to filter by
 * @param options - Search options, including whether to include nested properties
 * @returns True if the property matches the filter criteria, false otherwise
 */
 function filterProperties(property, filter, options = DEFAULT_OPTIONS) {
 	const { includeNestedProperties, limitToLeafPropertyValues } = withDefaultOptions(options);
-	if (filter.labelName.toLocaleLowerCase("en-US") === "all fields" || property.label.name.toLocaleLowerCase("en-US") === filter.labelName.toLocaleLowerCase("en-US")) {
+	if (filter.labelName.toLocaleLowerCase("en-US") === "all fields" || getPropertyVariableLabelName(property).toLocaleLowerCase("en-US") === filter.labelName.toLocaleLowerCase("en-US")) {
 		const values = getPropertyValuesResult(property.values, limitToLeafPropertyValues, false);
 		for (const value of values) if (contentMatchesFilter(value.content, filter.value.content)) return true;
 	}
-	if (includeNestedProperties) {
+	if (includeNestedProperties && "properties" in property) {
 		for (const nestedProperty of property.properties) if (filterProperties(nestedProperty, filter, {
 			includeNestedProperties: true,
 			limitToLeafPropertyValues
@@ -5613,12 +5616,21 @@ function parseCssStylesFromProperties(properties, cssVariant) {
 	for (const property of cssProperties) {
 		const value = property.values[0]?.content.toString();
 		if (value != null) styles.push({
-			label: property.label.name,
+			label: property.variable.label,
 			value
 		});
 	}
 	return styles;
 }
+function getPropertyValueMultilingualContent(propertyValue, options) {
+	if (propertyValue == null) return null;
+	if (propertyValue.label != null) return propertyValue.label;
+	if (typeof propertyValue.content === "string") return multilingualFromText(propertyValue.content, options);
+	return null;
+}
+function getPropertyMultilingualValueByLabelName(properties, labelName, options) {
+	return getPropertyValueMultilingualContent(getPropertyValueByLabelName(properties, labelName), options);
+}
 /**
 * Parses responsive CSS styles (default, tablet, mobile) from properties.
 *
@@ -5691,7 +5703,7 @@ function parseWebsiteOptions(rawOptions, options) {
 		contextTree: rawOptions == null ? null : parseAllOptionContexts(rawOptions, options),
 		labels: { title: null }
 	};
-	for (const note of parseNotes(rawOptions?.notes, options)) if (note.title === "Title label") {
+	for (const note of parseNotes(rawOptions?.notes, options)) if (note.title?.getText() === "Title label") {
 		parsedOptions.labels.title = note.content;
 		break;
 	}
@@ -6122,7 +6134,7 @@ function parseWebElementProperties(componentProperty, elementResource, options)
 			if (componentProperty.properties.length === 0) throw new Error(formatComponentError("Query properties not found", componentName, elementResource));
 			for (const queryItem of componentProperty.properties) {
 				const querySubProperties = queryItem.properties;
-				const label = getPropertyValueContentByLabelName(querySubProperties, "query-prompt");
+				const label = getPropertyMultilingualValueByLabelName(querySubProperties, "query-prompt", options);
 				if (label === null) continue;
 				const propertyVariables = getPropertyByLabelName(querySubProperties, "use-property")?.values.filter((value) => value.uuid !== null) ?? [];
 				const queryLanguage = options.languages[0];
@@ -6198,7 +6210,7 @@ function parseWebElementProperties(componentProperty, elementResource, options)
 			const linkToProperty = getPropertyByLabelName(componentProperty.properties, "link-to");
 			const href = linkToProperty?.values[0]?.href != null ? transformPermanentIdentificationUrlToItemLink(linkToProperty.values[0].href) : linkToProperty?.values[0]?.slug ?? null;
 			if (!boundElementUuid && !href) throw new Error(formatComponentError("Bound element or href not found", componentName, elementResource));
-			let placeholder = getPropertyValueContentByLabelName(componentProperty.properties, "placeholder-text");
+			let placeholder = getPropertyMultilingualValueByLabelName(componentProperty.properties, "placeholder-text", options);
 			placeholder ??= null;
 			let baseFilterQueries = getPropertyValueContentByLabelName(componentProperty.properties, "base-filter-queries");
 			baseFilterQueries ??= null;
@@ -6298,7 +6310,7 @@ function parseWebTitle(properties, identification, overrides) {
 */
 function parseWebElement(elementResource, options) {
 	const identification = parseIdentification(elementResource.identification, options);
-	const elementProperties = elementResource.properties?.property ? parseProperties(elementResource.properties, options) : [];
+	const elementProperties = elementResource.properties?.property ? parseSimplifiedProperties(elementResource.properties, options) : [];
 	const presentationProperty = getPropertyByLabelName(elementProperties, "presentation");
 	if (presentationProperty === null) throw new Error(`Presentation property not found for element (${formatXMLWebsiteResourceMetadata(elementResource)})`);
 	const componentProperty = getPropertyByLabelName(presentationProperty.properties, "component");
@@ -6327,7 +6339,7 @@ function parseWebElement(elementResource, options) {
 const parseWebpageResources = (webpageResources, type, options) => {
 	const returnElements = [];
 	for (const resource of webpageResources) {
-		if (getPropertyByLabelNameAndValueContent(resource.properties ? parseProperties(resource.properties, options) : [], "presentation", type) === null) continue;
+		if (getPropertyByLabelNameAndValueContent(resource.properties ? parseSimplifiedProperties(resource.properties, options) : [], "presentation", type) === null) continue;
 		switch (type) {
 			case "element": {
 				const element = parseWebElement(resource, options);
@@ -6355,7 +6367,7 @@ const parseWebpageResources = (webpageResources, type, options) => {
 * @returns Parsed Webpage object
 */
 function parseWebpage(webpageResource, options, slugPrefix) {
-	const webpageProperties = webpageResource.properties ? parseProperties(webpageResource.properties, options) : [];
+	const webpageProperties = webpageResource.properties ? parseSimplifiedProperties(webpageResource.properties, options) : [];
 	if (webpageProperties.length === 0 || getPropertyValueContentByLabelName(webpageProperties, "presentation") !== "page") return null;
 	const identification = parseIdentification(webpageResource.identification, options);
 	const slug = webpageResource.slug?.replace(SEGMENT_UNIQUE_SLUG_PREFIX_REGEX, "") ?? null;
@@ -6387,7 +6399,7 @@ function parseWebpage(webpageResource, options, slugPrefix) {
 	const webpageResources = webpageResource.resource != null ? normalizeWebsiteResources(webpageResource.resource) : [];
 	const items = [];
 	for (const resource of webpageResources) {
-		const resourceType = getPropertyValueContentByLabelName(resource.properties != null ? parseProperties(resource.properties, options) : [], "presentation");
+		const resourceType = getPropertyValueContentByLabelName(resource.properties != null ? parseSimplifiedProperties(resource.properties, options) : [], "presentation");
 		if (resourceType === null) continue;
 		switch (resourceType) {
 			case "segment": {
@@ -6450,7 +6462,7 @@ function parseWebpages(webpageResources, options, slugPrefix) {
 * @returns Parsed WebSegment object
 */
 function parseWebSegment(segmentResource, options, slugPrefix) {
-	const webpageProperties = segmentResource.properties ? parseProperties(segmentResource.properties, options) : [];
+	const webpageProperties = segmentResource.properties ? parseSimplifiedProperties(segmentResource.properties, options) : [];
 	if (webpageProperties.length === 0 || getPropertyValueContentByLabelName(webpageProperties, "presentation") !== "segment") return null;
 	const identification = parseIdentification(segmentResource.identification, options);
 	const slug = segmentResource.identification.abbreviation != null ? parseStringContent(segmentResource.identification.abbreviation, options) : null;
@@ -6487,7 +6499,7 @@ function parseSegments(segmentResources, options, slugPrefix) {
 * @returns Parsed WebSegmentItem object
 */
 function parseWebSegmentItem(segmentItemResource, options, slugPrefix) {
-	const webpageProperties = segmentItemResource.properties ? parseProperties(segmentItemResource.properties, options) : [];
+	const webpageProperties = segmentItemResource.properties ? parseSimplifiedProperties(segmentItemResource.properties, options) : [];
 	if (webpageProperties.length === 0 || getPropertyValueContentByLabelName(webpageProperties, "presentation") !== "segment-item") return null;
 	const identification = parseIdentification(segmentItemResource.identification, options);
 	const slug = segmentItemResource.identification.abbreviation != null ? parseStringContent(segmentItemResource.identification.abbreviation, options) : null;
@@ -6536,16 +6548,16 @@ function parseSidebar(resources, options) {
 		mobile: []
 	};
 	const sidebarResource = resources.find((resource) => {
-		const resourceProperties = resource.properties ? parseProperties(resource.properties, options) : [];
+		const resourceProperties = resource.properties ? parseSimplifiedProperties(resource.properties, options) : [];
 		return getPropertyValueContentByLabelName(resourceProperties, "presentation") === "element" && getPropertyValueContentByLabelName(resourceProperties[0]?.properties ?? [], "component") === "sidebar";
 	});
 	if (sidebarResource != null) {
-		const sidebarBaseProperties = sidebarResource.properties ? parseProperties(sidebarResource.properties, options) : [];
+		const sidebarBaseProperties = sidebarResource.properties ? parseSimplifiedProperties(sidebarResource.properties, options) : [];
 		title = parseWebTitle(sidebarBaseProperties, parseIdentification(sidebarResource.identification, options));
-		const sidebarProperties = sidebarBaseProperties.find((property) => property.label.name === "presentation" && property.values[0]?.content === "element")?.properties.find((property) => property.label.name === "component" && property.values[0]?.content === "sidebar")?.properties ?? [];
-		const sidebarLayoutProperty = sidebarProperties.find((property) => property.label.name === "layout");
+		const sidebarProperties = sidebarBaseProperties.find((property) => property.variable.label === "presentation" && property.values[0]?.content === "element")?.properties.find((property) => property.variable.label === "component" && property.values[0]?.content === "sidebar")?.properties ?? [];
+		const sidebarLayoutProperty = sidebarProperties.find((property) => property.variable.label === "layout");
 		if (sidebarLayoutProperty) layout = sidebarLayoutProperty.values[0].content;
-		const sidebarMobileLayoutProperty = sidebarProperties.find((property) => property.label.name === "layout-mobile");
+		const sidebarMobileLayoutProperty = sidebarProperties.find((property) => property.variable.label === "layout-mobile");
 		if (sidebarMobileLayoutProperty) mobileLayout = sidebarMobileLayoutProperty.values[0].content;
 		const parsedCssStyles = parseResponsiveCssStyles(sidebarBaseProperties);
 		cssStyles.default = parsedCssStyles.default;
@@ -6553,7 +6565,7 @@ function parseSidebar(resources, options) {
 		cssStyles.mobile = parsedCssStyles.mobile;
 		const sidebarResources = sidebarResource.resource ? normalizeWebsiteResources(sidebarResource.resource) : [];
 		for (const resource of sidebarResources) {
-			const resourceType = getPropertyValueContentByLabelName(resource.properties ? parseProperties(resource.properties, options) : [], "presentation");
+			const resourceType = getPropertyValueContentByLabelName(resource.properties ? parseSimplifiedProperties(resource.properties, options) : [], "presentation");
 			if (resourceType === null) continue;
 			switch (resourceType) {
 				case "element": {
@@ -6590,7 +6602,7 @@ function parseWebElementForAccordion(elementResource, options) {
 	const childResources = elementResource.resource ? normalizeWebsiteResources(elementResource.resource) : [];
 	const items = [];
 	for (const resource of childResources) {
-		const resourceType = getPropertyValueContentByLabelName(resource.properties ? parseProperties(resource.properties, options) : [], "presentation");
+		const resourceType = getPropertyValueContentByLabelName(resource.properties ? parseSimplifiedProperties(resource.properties, options) : [], "presentation");
 		if (resourceType === null) continue;
 		switch (resourceType) {
 			case "element": {
@@ -6617,7 +6629,7 @@ function parseWebElementForAccordion(elementResource, options) {
 * @returns Parsed WebBlock object
 */
 function parseWebBlock(blockResource, options) {
-	const blockProperties = blockResource.properties ? parseProperties(blockResource.properties, options) : [];
+	const blockProperties = blockResource.properties ? parseSimplifiedProperties(blockResource.properties, options) : [];
 	const returnBlock = {
 		uuid: blockResource.uuid,
 		type: "block",
@@ -6695,7 +6707,7 @@ function parseWebBlock(blockResource, options) {
 	if (returnBlock.properties.default.layout === "accordion") {
 		const accordionItems = [];
 		for (const resource of blockResources) {
-			const resourceProperties = resource.properties ? parseProperties(resource.properties, options) : [];
+			const resourceProperties = resource.properties ? parseSimplifiedProperties(resource.properties, options) : [];
 			const resourceType = getPropertyValueContentByLabelName(resourceProperties, "presentation");
 			if (resourceType !== "element") throw new Error(`Accordion only accepts elements, but got “${resourceType}” (${formatXMLWebsiteResourceMetadata(resource)})`);
 			const componentType = getPropertyValueContentByLabelName(getPropertyByLabelName(resourceProperties, "presentation")?.properties ?? [], "component");
@@ -6707,7 +6719,7 @@ function parseWebBlock(blockResource, options) {
 	} else {
 		const blockItems = [];
 		for (const resource of blockResources) {
-			const resourceType = getPropertyValueContentByLabelName(resource.properties ? parseProperties(resource.properties, options) : [], "presentation");
+			const resourceType = getPropertyValueContentByLabelName(resource.properties ? parseSimplifiedProperties(resource.properties, options) : [], "presentation");
 			if (resourceType === null) continue;
 			switch (resourceType) {
 				case "element": {
@@ -6734,7 +6746,7 @@ function parseWebBlock(blockResource, options) {
 * @returns Parsed WebsiteProperties object
 */
 function parseWebsiteProperties(properties, websiteTree, sidebar, options) {
-	const websiteProperties = getPropertyByLabelName(parseProperties({ property: properties }, options), "presentation")?.properties ?? [];
+	const websiteProperties = getPropertyByLabelName(parseSimplifiedProperties({ property: properties }, options), "presentation")?.properties ?? [];
 	let type = getPropertyValueContentByLabelName(websiteProperties, "webUI");
 	type ??= "traditional";
 	let status = getPropertyValueContentByLabelName(websiteProperties, "status");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ochre-sdk",
-  "version": "1.0.0-beta.6",
+  "version": "1.0.0-beta.8",
   "type": "module",
   "license": "MIT",
   "description": "Node.js library for working with OCHRE (Online Cultural and Historical Research Environment) data",