ochre-sdk 1.3.3 → 1.3.5

package/dist/fetchers/set/property-values.mjs

@@ -48,8 +48,8 @@ function normalizePropertyValueDataType(dataType) {
 function sortPropertyValues(values) {
 	return values.toSorted((a, b) => {
 		if (a.count !== b.count) return b.count - a.count;
-		const label = a.label?.getText() ?? null;
-		const otherLabel = b.label?.getText() ?? null;
+		const label = a.label?.getText(a.label.getDefaultLanguage()) ?? null;
+		const otherLabel = b.label?.getText(b.label.getDefaultLanguage()) ?? null;
 		if (label !== otherLabel) return label?.localeCompare(otherLabel ?? "") ?? 0;
 		return a.content?.toString().localeCompare(b.content?.toString() ?? "") ?? 0;
 	});

package/dist/fetchers/website-metadata.mjs

@@ -26,7 +26,7 @@ function parseWebsiteMetadata(data, options) {
 	const websiteTree = rawOchre.tree[0];
 	if (websiteTree == null) throw new Error("Website tree not found", { cause: data });
 	const identification = parseIdentification(websiteTree.identification, options);
-	const websiteName = identification.label.getText().trim();
+	const websiteName = identification.label.getText(identification.label.getDefaultLanguage()).trim();
 	const metadataDescription = (parseStringLike(rawOchre.metadata.description) ?? "").trim();
 	const properties = parseSimplifiedProperties(websiteTree.properties, options);
 	const reader = websitePresentationReader(properties);

package/dist/getters.mjs

@@ -27,7 +27,7 @@ function withDefaultOptions(options) {
 	};
 }
 function getPropertyVariableLabel(property) {
-	return typeof property.variable.label === "string" ? property.variable.label : property.variable.label.getText();
+	return typeof property.variable.label === "string" ? property.variable.label : property.variable.label.getText(property.variable.label.getDefaultLanguage());
 }
 function hasPropertyValue(property, value) {
 	for (const candidateValue of property.values) if (deepEqual(candidateValue, value)) return true;

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { MultilingualOptions, MultilingualString, MultilingualStringEntries, MultilingualStringEntry, MultilingualStringInput, MultilingualStringJSON, MultilingualStringObject, MultilingualStringText } from "./parsers/multilingual.mjs";
-import { AccordionWebBlock, ContextTree, ContextTreeFilterLevel, ContextTreeFilterVariant, ContextTreeLevel, ContextTreeLevelItem, ProtectedWebsite, ResponsiveStyles, Scope, Style, StylesheetCategory, StylesheetItem, WebAccordionItem, WebBlock, WebBlockByLayout, WebBlockItem, WebBlockLayout, WebElement, WebElementComponent, WebElementComponentName, WebElementComponentOf, WebElementOf, WebIiifViewer, WebImage, WebLoadingVariant, WebOptions, WebSectionDisplay, WebSectionVariant, WebSidebar, WebTitle, Webpage, Website, WebsiteMetadata, WebsitePrivacy, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteSegment, WebsiteType } from "./types/website.mjs";
+import { AccordionWebBlock, ContextTree, ContextTreeFilterLevel, ContextTreeFilterVariant, ContextTreeLevel, ContextTreeLevelItem, ProtectedWebsite, ResponsiveStyles, Scope, Style, StylesheetCategory, StylesheetItem, WebAccordionItem, WebBlock, WebBlockByLayout, WebBlockItem, WebBlockLayout, WebElement, WebElementComponent, WebElementComponentName, WebElementComponentOf, WebElementOf, WebIiifViewer, WebImage, WebLoadingVariant, WebOptions, WebRelationVariant, WebSectionDisplay, WebSectionVariant, WebSidebar, WebTitle, Webpage, Website, WebsiteMetadata, WebsitePrivacy, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteSegment, WebsiteType } from "./types/website.mjs";
 import { AnyBibliography, AnyConcept, AnyItem, AnyPeriod, AnyPerson, AnyPropertyValue, AnyPropertyVariable, AnyResource, AnySet, AnySpatialUnit, AnyText, AnyTree, BaseItem, BaseItemLink, BelongsTo, Bibliography, BibliographyEntryInfo, BibliographyItemLink, BibliographySourceDocument, Concept, ConceptItemLink, ContainedItemCategory, ContainedItemCategoryFromOption, ContainedItemCategoryOption, Context, ContextItem, ContextItemCategory, ContextNode, Coordinates, CoordinatesSource, DictionaryUnitItemLink, EmbeddedBibliography, EmbeddedConcept, EmbeddedItem, EmbeddedPeriod, EmbeddedPerson, EmbeddedPropertyValue, EmbeddedPropertyVariable, EmbeddedResource, EmbeddedSet, EmbeddedSpatialUnit, EmbeddedText, EmbeddedTree, Event, Gallery, Heading, HeadingItemCategory, Identification, Image, ImageMap, ImageMapArea, Interpretation, Item, ItemCategory, ItemCategoryFromOption, ItemCategoryOption, ItemCategoryWithEmbeddedItems, ItemContainerCategory, ItemLink, ItemLinkCategory, ItemLinks, ItemPayloadKind, ItemProperty, ItemWithoutEmbeddedItems, LanguageCodes, License, Metadata, Note, Observation, OcrString, Period, PeriodItemLink, Person, PersonItemLink, Property, PropertyLike, PropertyRelation, PropertyValue, PropertyValueContent, PropertyValueDataType, PropertyValueItemLink, PropertyValueQueryItem, PropertyVariable, PropertyVariableItemLink, Query, QueryGroup, QueryLeaf, QueryablePropertyValueDataType, RecursiveItemCategory, Resource, ResourceItemLink, Section, Set, SetAttributeValueQueryItem, SetBibliography, SetConcept, SetItem, SetItemCategory, SetItemLink, SetItemLocation, SetItemProperty, SetItemSimplifiedProperty, SetItemsSort, SetItemsSortDirection, SetPeriod, SetResource, SetSpatialUnit, SetStyle, SetStyleProperty, SetTree, SimplifiedProperty, SpatialUnit, SpatialUnitItemLink, Text, TextItemLink, TopLevelItem, Tree, TreeItemCategory, TreeItemLink } from "./types/index.mjs";
 import { DEFAULT_PAGE_SIZE } from "./constants.mjs";
 import { fetchGallery } from "./fetchers/gallery.mjs";
@@ -16,4 +16,4 @@ import { fetchWebsite } from "./fetchers/website.mjs";
 import { PropertyOptions, PropertySelector, getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel } from "./getters.mjs";
 import { flattenItemProperties } from "./helpers.mjs";
 import { defineLanguages } from "./parsers/languages.mjs";
-export { type AccordionWebBlock, type AnyBibliography, type AnyConcept, type AnyItem, type AnyPeriod, type AnyPerson, type AnyPropertyValue, type AnyPropertyVariable, type AnyResource, type AnySet, type AnySpatialUnit, type AnyText, type AnyTree, type BaseItem, type BaseItemLink, type BelongsTo, type Bibliography, type BibliographyEntryInfo, type BibliographyItemLink, type BibliographySourceDocument, type Concept, type ConceptItemLink, type ContainedItemCategory, type ContainedItemCategoryFromOption, type ContainedItemCategoryOption, type Context, type ContextItem, type ContextItemCategory, type ContextNode, type ContextTree, type ContextTreeFilterLevel, type ContextTreeFilterVariant, type ContextTreeLevel, type ContextTreeLevelItem, type Coordinates, type CoordinatesSource, DEFAULT_PAGE_SIZE, type DictionaryUnitItemLink, type EmbeddedBibliography, type EmbeddedConcept, type EmbeddedItem, type EmbeddedPeriod, type EmbeddedPerson, type EmbeddedPropertyValue, type EmbeddedPropertyVariable, type EmbeddedResource, type EmbeddedSet, type EmbeddedSpatialUnit, type EmbeddedText, type EmbeddedTree, type Event, type Gallery, type Heading, type HeadingItemCategory, type Identification, type Image, type ImageMap, type ImageMapArea, type Interpretation, type Item, type ItemCategory, type ItemCategoryFromOption, type ItemCategoryOption, type ItemCategoryWithEmbeddedItems, type ItemContainerCategory, type ItemLink, type ItemLinkCategory, type ItemLinks, type ItemPayloadKind, type ItemProperty, type ItemWithoutEmbeddedItems, type LanguageCodes, type License, type Metadata, type MultilingualOptions, MultilingualString, type MultilingualStringEntries, type MultilingualStringEntry, type MultilingualStringInput, type MultilingualStringJSON, type MultilingualStringObject, type MultilingualStringText, type Note, type Observation, type OcrString, type Period, type PeriodItemLink, type Person, type PersonItemLink, type Property, type PropertyLike, type PropertyOptions, type PropertyRelation, type PropertySelector, type PropertyValue, type PropertyValueContent, type PropertyValueDataType, type PropertyValueItemLink, type PropertyValueQueryItem, type PropertyVariable, type PropertyVariableItemLink, type ProtectedWebsite, type Query, type QueryGroup, type QueryLeaf, type QueryablePropertyValueDataType, type RecursiveItemCategory, type Resource, type ResourceItemLink, type ResponsiveStyles, type Scope, type Section, type Set, type SetAttributeValueQueryItem, type SetBibliography, type SetConcept, type SetItem, type SetItemCategory, type SetItemLink, type SetItemLocation, type SetItemProperty, type SetItemSimplifiedProperty, type SetItemsSort, type SetItemsSortDirection, type SetPeriod, type SetResource, type SetSpatialUnit, type SetStyle, type SetStyleProperty, type SetTree, type SimplifiedProperty, type SpatialUnit, type SpatialUnitItemLink, type Style, type StylesheetCategory, type StylesheetItem, type Text, type TextItemLink, type TopLevelItem, type Tree, type TreeItemCategory, type TreeItemLink, type WebAccordionItem, type WebBlock, type WebBlockByLayout, type WebBlockItem, type WebBlockLayout, type WebElement, type WebElementComponent, type WebElementComponentName, type WebElementComponentOf, type WebElementOf, type WebIiifViewer, type WebImage, type WebLoadingVariant, type WebOptions, type WebSectionDisplay, type WebSectionVariant, type WebSidebar, type WebTitle, type Webpage, type Website, type WebsiteMetadata, type WebsitePrivacy, type WebsitePropertyQuery, type WebsitePropertyQueryNode, type WebsiteSegment, type WebsiteType, defineLanguages, fetchGallery, fetchItem, fetchItemChildren, fetchItemLinks, fetchItemOcrData, fetchSetItemLocations, fetchSetItems, fetchSetPropertyValues, fetchTreeItems, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel };
+export { type AccordionWebBlock, type AnyBibliography, type AnyConcept, type AnyItem, type AnyPeriod, type AnyPerson, type AnyPropertyValue, type AnyPropertyVariable, type AnyResource, type AnySet, type AnySpatialUnit, type AnyText, type AnyTree, type BaseItem, type BaseItemLink, type BelongsTo, type Bibliography, type BibliographyEntryInfo, type BibliographyItemLink, type BibliographySourceDocument, type Concept, type ConceptItemLink, type ContainedItemCategory, type ContainedItemCategoryFromOption, type ContainedItemCategoryOption, type Context, type ContextItem, type ContextItemCategory, type ContextNode, type ContextTree, type ContextTreeFilterLevel, type ContextTreeFilterVariant, type ContextTreeLevel, type ContextTreeLevelItem, type Coordinates, type CoordinatesSource, DEFAULT_PAGE_SIZE, type DictionaryUnitItemLink, type EmbeddedBibliography, type EmbeddedConcept, type EmbeddedItem, type EmbeddedPeriod, type EmbeddedPerson, type EmbeddedPropertyValue, type EmbeddedPropertyVariable, type EmbeddedResource, type EmbeddedSet, type EmbeddedSpatialUnit, type EmbeddedText, type EmbeddedTree, type Event, type Gallery, type Heading, type HeadingItemCategory, type Identification, type Image, type ImageMap, type ImageMapArea, type Interpretation, type Item, type ItemCategory, type ItemCategoryFromOption, type ItemCategoryOption, type ItemCategoryWithEmbeddedItems, type ItemContainerCategory, type ItemLink, type ItemLinkCategory, type ItemLinks, type ItemPayloadKind, type ItemProperty, type ItemWithoutEmbeddedItems, type LanguageCodes, type License, type Metadata, type MultilingualOptions, MultilingualString, type MultilingualStringEntries, type MultilingualStringEntry, type MultilingualStringInput, type MultilingualStringJSON, type MultilingualStringObject, type MultilingualStringText, type Note, type Observation, type OcrString, type Period, type PeriodItemLink, type Person, type PersonItemLink, type Property, type PropertyLike, type PropertyOptions, type PropertyRelation, type PropertySelector, type PropertyValue, type PropertyValueContent, type PropertyValueDataType, type PropertyValueItemLink, type PropertyValueQueryItem, type PropertyVariable, type PropertyVariableItemLink, type ProtectedWebsite, type Query, type QueryGroup, type QueryLeaf, type QueryablePropertyValueDataType, type RecursiveItemCategory, type Resource, type ResourceItemLink, type ResponsiveStyles, type Scope, type Section, type Set, type SetAttributeValueQueryItem, type SetBibliography, type SetConcept, type SetItem, type SetItemCategory, type SetItemLink, type SetItemLocation, type SetItemProperty, type SetItemSimplifiedProperty, type SetItemsSort, type SetItemsSortDirection, type SetPeriod, type SetResource, type SetSpatialUnit, type SetStyle, type SetStyleProperty, type SetTree, type SimplifiedProperty, type SpatialUnit, type SpatialUnitItemLink, type Style, type StylesheetCategory, type StylesheetItem, type Text, type TextItemLink, type TopLevelItem, type Tree, type TreeItemCategory, type TreeItemLink, type WebAccordionItem, type WebBlock, type WebBlockByLayout, type WebBlockItem, type WebBlockLayout, type WebElement, type WebElementComponent, type WebElementComponentName, type WebElementComponentOf, type WebElementOf, type WebIiifViewer, type WebImage, type WebLoadingVariant, type WebOptions, type WebRelationVariant, type WebSectionDisplay, type WebSectionVariant, type WebSidebar, type WebTitle, type Webpage, type Website, type WebsiteMetadata, type WebsitePrivacy, type WebsitePropertyQuery, type WebsitePropertyQueryNode, type WebsiteSegment, type WebsiteType, defineLanguages, fetchGallery, fetchItem, fetchItemChildren, fetchItemLinks, fetchItemOcrData, fetchSetItemLocations, fetchSetItems, fetchSetPropertyValues, fetchTreeItems, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel };

package/dist/parsers/helpers.mjs

@@ -58,15 +58,19 @@ function parseRequiredContentLike(value, options) {
 	return parseContentLike(value, options) ?? MultilingualString.empty(options.languages, { defaultLanguage: options.defaultLanguage });
 }
 function parseContentLikeText(value, options) {
-	return parseContentLike(value, options)?.getText().trim() ?? "";
+	const content = parseContentLike(value, options);
+	return content?.getText(content.getDefaultLanguage()).trim() ?? "";
 }
 function parseStringContent(value, options = FALLBACK_PARSER_OPTIONS) {
 	if (value == null) return "";
 	if (typeof value === "string") return value;
-	if (isXMLContent(value)) return parseXMLContent(value, {
-		languages: options.languages,
-		defaultLanguage: options.defaultLanguage
-	}).getText();
+	if (isXMLContent(value)) {
+		const content = parseXMLContent(value, {
+			languages: options.languages,
+			defaultLanguage: options.defaultLanguage
+		});
+		return content.getText(content.getDefaultLanguage());
+	}
 	return parseXMLString(value).text;
 }
 //#endregion

package/dist/parsers/index.mjs

@@ -457,7 +457,7 @@ function parsePropertyDataType(dataType) {
 function parsePropertyValueContent(value, options) {
 	const dataType = parsePropertyDataType(value.dataType);
 	const rawLabel = value.content != null ? parseRequiredContentLike(value, options) : value.payload != null && value.payload !== "" ? multilingualFromText(value.payload, options) : null;
-	const contentText = readPropertyValueText(value, () => rawLabel?.getText() ?? null);
+	const contentText = readPropertyValueText(value, () => rawLabel?.getText(rawLabel.getDefaultLanguage()) ?? null);
 	const common = {
 		hierarchy: {
 			isLeaf: value.inherited == null || !value.inherited,

package/dist/parsers/languages.d.mts

@@ -40,13 +40,11 @@ export declare function resolveContentLanguages(node: unknown, requestedLanguage
  * Read the languages a dataset declares in its metadata
  * @param rawOchre - The raw OCHRE payload root
  * @param rawOchre.metadata - The payload metadata declaring the languages
- * @param rawOchre.languages - The semicolon-separated fallback language list
  * @returns The declared languages, falling back to {@link DEFAULT_LANGUAGES}
  * @internal
  */
 export declare function parseMetadataLanguages(rawOchre: {
   metadata: XMLMetadata;
-  languages?: string;
 }): Array<string>;
 /**
  * Reconcile requested languages against the ones a dataset declares

package/dist/parsers/languages.mjs

@@ -76,7 +76,6 @@ function resolveContentLanguages(node, requestedLanguages) {
 * Read the languages a dataset declares in its metadata
 * @param rawOchre - The raw OCHRE payload root
 * @param rawOchre.metadata - The payload metadata declaring the languages
-* @param rawOchre.languages - The semicolon-separated fallback language list
 * @returns The declared languages, falling back to {@link DEFAULT_LANGUAGES}
 * @internal
 */
@@ -87,10 +86,6 @@ function parseMetadataLanguages(rawOchre) {
 		const parsedLanguage = parseStringLike(language);
 		if (parsedLanguage != null) languages.push(parsedLanguage);
 	}
-	if (languages.length > 0) return languages;
-	if (rawOchre.languages != null) {
-		for (const language of rawOchre.languages.split(";")) if (language !== "") languages.push(language);
-	}
 	return languages.length > 0 ? languages : [...DEFAULT_LANGUAGES];
 }
 /**

package/dist/parsers/multilingual.d.mts

@@ -109,11 +109,11 @@ export declare class MultilingualString<T extends ReadonlyArray<string> = Readon
   /**
    * Get text in a specific language, falling back when it has none
    */
-  getText(language?: T[number]): string;
+  getText(language: T[number]): string;
   /**
    * Get rich text in a specific language, falling back when it has none
    */
-  getRichText(language?: T[number]): string;
+  getRichText(language: T[number]): string;
   /**
    * Get text in a specific language, with no fallback
    */
@@ -133,16 +133,16 @@ export declare class MultilingualString<T extends ReadonlyArray<string> = Readon
    * can carry several entries for one language, and this returns all of them
    * rather than only the primary. Each entry carries both `text` and
    * `richText`, so a caller rendering a rich field reads them from here.
-   * @param language - The language to read, or undefined for the default
+   * @param language - The language to read
    * @returns The entries, or an empty array when no language has any
    */
-  getEntries(language?: T[number]): Array<MultilingualStringEntry>;
+  getEntries(language: T[number]): Array<MultilingualStringEntry>;
   /**
    * Get the text of every entry for a language, falling back when it has none
-   * @param language - The language to read, or undefined for the default
+   * @param language - The language to read
    * @returns The texts, or an empty array when no language has any
    */
-  getTexts(language?: T[number]): Array<string>;
+  getTexts(language: T[number]): Array<string>;
   /**
    * Get the text of every entry for a language, with no fallback
    * @param language - The language to read
@@ -259,10 +259,6 @@ export declare class MultilingualString<T extends ReadonlyArray<string> = Readon
    * @returns A new multilingual string
    */
   filterEntries(shouldKeep: (entry: MultilingualStringEntry, language: T[number]) => boolean): MultilingualString<T>;
-  /**
-   * Get the string representation, using the default language
-   */
-  toString(): string;
   /**
    * Get the JSON representation
    *

package/dist/parsers/multilingual.mjs

@@ -228,7 +228,7 @@ var MultilingualString = class MultilingualString {
 	* can carry several entries for one language, and this returns all of them
 	* rather than only the primary. Each entry carries both `text` and
 	* `richText`, so a caller rendering a rich field reads them from here.
-	* @param language - The language to read, or undefined for the default
+	* @param language - The language to read
 	* @returns The entries, or an empty array when no language has any
 	*/
 	getEntries(language) {
@@ -236,7 +236,7 @@ var MultilingualString = class MultilingualString {
 	}
 	/**
 	* Get the text of every entry for a language, falling back when it has none
-	* @param language - The language to read, or undefined for the default
+	* @param language - The language to read
 	* @returns The texts, or an empty array when no language has any
 	*/
 	getTexts(language) {
@@ -423,12 +423,6 @@ var MultilingualString = class MultilingualString {
 		}, newAvailableLanguages);
 	}
 	/**
-	* Get the string representation, using the default language
-	*/
-	toString() {
-		return this.getText();
-	}
-	/**
 	* Get the JSON representation
 	*
 	* Carries `defaultLanguage`, because it is not derivable from the content:

package/dist/parsers/website/components.mjs

@@ -85,6 +85,23 @@ function parseCollectionDisplayedProperties(reader) {
 		label: value.label
 	}]);
 }
+/**
+* Parses the "customize-special" "relations" properties, each pairing the
+* property variables it links with "use-property" with a display "variant".
+*/
+function parseCollectionRelations(reader) {
+	const relations = [];
+	const relationReaders = reader.nestedAllByValue("customize-special", "relations");
+	for (const relationReader of relationReaders) {
+		const variant = relationReader.value("variant");
+		const properties = parseCollectionDisplayedProperties(relationReader) ?? [];
+		for (const property of properties) relations.push({
+			...property,
+			variant
+		});
+	}
+	return relations;
+}
 const THREE_D_VIEWER_COMPONENT_DEFAULTS = {
 	isInteractive: true,
 	isControlsDisplayed: true
@@ -261,6 +278,7 @@ function parseCollectionComponent(parameters) {
 		component: "collection",
 		linkUuids: setLinks.map((link) => link.uuid),
 		displayedProperties: parseCollectionDisplayedProperties(componentReader),
+		relations: parseCollectionRelations(componentReader),
 		...COLLECTION_PROPERTY_DEFAULTS,
 		...propertyOverrides,
 		image: {
@@ -472,9 +490,12 @@ function parseQueryComponent(parameters) {
 	}
 	if (items.length === 0) throw new Error(formatComponentError("No queries found", "query", elementResource), { cause: componentProperty });
 	const componentOptions = parseWebsiteOptions(elementResource.options, options);
-	const collectionProperties = parseCollectionPropertyOverrides(componentReader.nestedByValue("sub-component-override", "collection"));
+	const overrideReader = componentReader.nestedByValue("sub-component-override", "collection");
+	const collectionProperties = parseCollectionPropertyOverrides(overrideReader);
 	const displayedProperties = parseCollectionDisplayedProperties(componentReader);
 	if (displayedProperties != null) collectionProperties.displayedProperties = displayedProperties;
+	const relations = parseCollectionRelations(overrideReader);
+	if (relations.length > 0) collectionProperties.relations = relations;
 	return {
 		component: "query",
 		linkUuids: setLinks.map((link) => link.uuid),

package/dist/parsers/website/options.mjs

@@ -104,7 +104,7 @@ function parseWebsiteOptions(rawOptions, options) {
 	};
 	const notes = parseNotes(rawOptions?.notes, options);
 	for (const note of notes) {
-		if (note.title?.getText() !== "Title label") continue;
+		if (note.title?.getText(note.title.getDefaultLanguage()) !== "Title label") continue;
 		parsedOptions.labels.title = note.content;
 		break;
 	}

package/dist/parsers/website/properties.mjs

@@ -76,6 +76,7 @@ function parseWebsiteProperties(properties, websiteTree, sidebar, options, paren
 			isPersistentIdentifierDisplayed: parent?.itemPage.isPersistentIdentifierDisplayed ?? true,
 			iiifViewer: parent?.itemPage.iiifViewer ?? "universal-viewer"
 		},
+		relations: { variant: parent?.relations.variant ?? "list" },
 		options: {
 			contextTree: parent?.options.contextTree ?? null,
 			scopes: parent?.options.scopes ?? null,
@@ -117,7 +118,7 @@ function parseWebsiteProperties(properties, websiteTree, sidebar, options, paren
 	websiteReader.readAllUuids(returnProperties.navbar, { searchBarBoundElementUuid: "bound-element-navbar-search-bar" });
 	websiteReader.readAll(returnProperties.footer, { isDisplayed: "footer-displayed" });
 	websiteReader.readAllUuids(returnProperties.footer, { logoUuid: "footer-logo" });
-	const itemPageReader = websiteReader.nestedByValue("page-type", "item-page");
+	const itemPageReader = websiteReader.nestedByValue("customize-special", "item-page");
 	if (itemPageReader.size > 0) {
 		for (const [key, slug] of [
 			["description", "description"],
@@ -142,6 +143,7 @@ function parseWebsiteProperties(properties, websiteTree, sidebar, options, paren
 			iiifViewer: "item-page-iiif-viewer"
 		});
 	}
+	websiteReader.nestedByValue("customize-special", "relations").readAll(returnProperties.relations, { variant: "variant" });
 	if (websiteTree.options != null) {
 		const parsedOptions = parseWebsiteOptions(websiteTree.options, options);
 		returnProperties.options.scopes = (parsedOptions.scopes != null && parsedOptions.scopes.length > 0 ? parsedOptions : returnProperties.options).scopes;

package/dist/parsers/website/reader.d.mts

@@ -70,6 +70,7 @@ export declare class WebsitePresentationReader<T extends LanguageCodes> {
   readAllUuids<O extends object>(target: O, labels: Partial<Record<UuidKeys<O>, string>>): void;
   nested(label: string): WebsitePresentationReader<T>;
   nestedByValue(label: string, value: WebsitePropertyContent<T>): WebsitePresentationReader<T>;
+  nestedAllByValue(label: string, value: WebsitePropertyContent<T>): Array<WebsitePresentationReader<T>>;
   get size(): number;
 }
 export declare function websitePresentationReader<T extends LanguageCodes>(properties: ReadonlyArray<SimplifiedProperty<T>>): WebsitePresentationReader<T>;

package/dist/parsers/website/reader.mjs

@@ -103,6 +103,14 @@ var WebsitePresentationReader = class WebsitePresentationReader {
 	nestedByValue(label, value) {
 		return new WebsitePresentationReader(this.propertyByValue(label, value)?.properties ?? []);
 	}
+	nestedAllByValue(label, value) {
+		const readers = [];
+		for (const property of this.sourceProperties) if (getProperty([property], {
+			label,
+			valueContent: value
+		}) != null) readers.push(new WebsitePresentationReader(property.properties));
+		return readers;
+	}
 	get size() {
 		return this.sourceProperties.length;
 	}

package/dist/types/website.d.mts

@@ -87,6 +87,10 @@ export type WebLoadingVariant = "spinner" | "skeleton" | "animation" | "none";
  * How an item page groups a repeated section
  */
 export type WebSectionVariant = "discrete" | "tabs-horizontal" | "tabs-vertical" | "tabular";
+/**
+ * How a website displays an item's related items
+ */
+export type WebRelationVariant = "list" | "dropdown-list" | "grid" | "gallery" | "inline";
 /**
  * The IIIF viewer a website renders images with
  */
@@ -206,6 +210,9 @@ export type Website<T extends LanguageCodes = LanguageCodes> = {
       isPersistentIdentifierDisplayed: boolean;
       iiifViewer: WebIiifViewer;
     };
+    relations: {
+      variant: WebRelationVariant;
+    };
     options: Prettify<WebOptions<T> & {
       stylesheets: {
         properties: Array<StylesheetItem>;
@@ -336,6 +343,11 @@ export type WebElementComponent<T extends LanguageCodes = LanguageCodes> = {
     uuid: string;
     label: MultilingualString<T> | null;
   }> | null;
+  relations: Array<{
+    uuid: string;
+    label: MultilingualString<T> | null;
+    variant: WebRelationVariant | null;
+  }>;
   variant: "slide" | "table" | "card" | "tile" | "showcase";
   paginationVariant: "default" | "numeric";
   loadingVariant: WebLoadingVariant;

package/dist/xml/schemas.d.mts

@@ -5193,7 +5193,6 @@ export declare const XMLWebsiteData: v.ObjectSchema<{
         }, "XMLMetadata: item is object with identification, category, type, and maxLength">, undefined>;
       }, undefined>;
       readonly persistentUrl: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<"XMLWebsiteData: persistentUrl is string and optional">, v.UrlAction<string, "XMLWebsiteData: persistentUrl is not a valid URL">]>, undefined>;
-      readonly languages: v.OptionalSchema<v.StringSchema<"XMLWebsiteData: languages is string and optional">, undefined>;
       readonly tree: v.ArraySchema<v.LazySchema<v.ObjectSchema<{
         readonly type: v.OptionalSchema<v.StringSchema<"XMLWebsiteTree: type is string and optional">, undefined>;
         readonly date: v.OptionalSchema<v.UnionSchema<[v.GenericSchema<unknown, Date>, v.ObjectSchema<{

package/dist/xml/schemas.mjs

@@ -949,9 +949,8 @@ const XMLData = v.object({ result: v.object({ ochre: v.intersect([v.object({
 	uuidBelongsTo: v.pipe(v.string("XMLData: uuidBelongsTo is string and required"), v.check(isPseudoUuid, "XMLData: uuidBelongsTo is not a valid pseudo-UUID")),
 	publicationDateTime: customDateTime("XMLData: publicationDateTime is not a valid datetime"),
 	metadata: XMLMetadata,
-	persistentUrl: v.optional(v.pipe(v.string("XMLData: persistentUrl is string and optional"), v.url("XMLData: persistentUrl is not a valid URL"))),
-	languages: v.optional(v.string("XMLData: languages is string and optional"))
-}, "XMLData: ochre is object with uuid, belongsTo, uuidBelongsTo, publicationDateTime, metadata, and languages"), XMLTopLevelDataItem]) }) }, "XMLData: Shape error");
+	persistentUrl: v.optional(v.pipe(v.string("XMLData: persistentUrl is string and optional"), v.url("XMLData: persistentUrl is not a valid URL")))
+}, "XMLData: ochre is object with uuid, belongsTo, uuidBelongsTo, publicationDateTime, and metadata"), XMLTopLevelDataItem]) }) }, "XMLData: Shape error");
 const XMLWebsiteData = v.object({ result: v.object({ ochre: v.object({
 	uuid: v.pipe(v.string("XMLWebsiteData: uuid is string and required"), v.check(isPseudoUuid, "XMLWebsiteData: uuid is not a valid pseudo-UUID")),
 	belongsTo: v.string("XMLWebsiteData: belongsTo is string and required"),
@@ -959,7 +958,6 @@ const XMLWebsiteData = v.object({ result: v.object({ ochre: v.object({
 	publicationDateTime: customDateTime("XMLWebsiteData: publicationDateTime is not a valid datetime"),
 	metadata: XMLMetadata,
 	persistentUrl: v.optional(v.pipe(v.string("XMLWebsiteData: persistentUrl is string and optional"), v.url("XMLWebsiteData: persistentUrl is not a valid URL"))),
-	languages: v.optional(v.string("XMLWebsiteData: languages is string and optional")),
 	tree: v.array(XMLWebsiteTree)
 }, "XMLWebsiteData: ochre is object with website tree") }, "XMLWebsiteData: result is object with ochre") }, "XMLWebsiteData: Shape error");
 //#endregion

package/dist/xml/types.d.mts

@@ -919,7 +919,6 @@ export type XMLData = {
       publicationDateTime: Date;
       metadata: XMLMetadata;
       persistentUrl?: string;
-      languages?: string;
     } & XMLDataItem;
   };
 };
@@ -932,7 +931,6 @@ export type XMLWebsiteData = {
       publicationDateTime: Date;
       metadata: XMLMetadata;
       persistentUrl?: string;
-      languages?: string;
       tree: Array<XMLWebsiteTree>;
     };
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ochre-sdk",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "type": "module",
   "license": "MIT",
   "description": "Node.js library for working with OCHRE (Online Cultural and Historical Research Environment) data",
@@ -45,20 +45,20 @@
     "dist"
   ],
   "dependencies": {
-    "fast-equals": "^6.0.4",
+    "fast-equals": "^6.1.0",
     "fast-xml-parser": "^5.11.2",
     "valibot": "^1.5.0"
   },
   "devDependencies": {
     "@antfu/eslint-config": "^9.5.1",
-    "@types/node": "^24.19.0",
+    "@types/node": "^24.19.1",
     "bumpp": "^12.3.0",
-    "eslint": "^10.11.0",
+    "eslint": "^10.12.0",
     "eslint-plugin-erasable-syntax-only": "^0.7.2",
     "eslint-plugin-slop": "^0.1.3",
     "eslint-plugin-sonarjs": "^4.2.2",
-    "knip": "^6.39.0",
-    "oxfmt": "^0.71.0",
+    "knip": "^6.40.0",
+    "oxfmt": "^0.72.0",
     "tsdown": "^0.23.0",
     "typescript": "^6.0.3",
     "vitest": "^5.0.3"