ochre-sdk 1.3.3 → 1.3.4

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ochre-sdk",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "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",
+    "oxfmt": "^0.72.0",
     "tsdown": "^0.23.0",
     "typescript": "^6.0.3",
     "vitest": "^5.0.3"