ochre-sdk 0.22.23 → 1.0.0-beta.2

package/dist/index.d.mts

@@ -1,234 +1,326 @@
-//#region src/types/index.d.ts
+//#region src/parsers/multilingual.d.ts
 /**
- * Represents the OCHRE API version
+ * One text entry for a language. When OCHRE exposes multiple entries for the
+ * same language, the first one is primary.
  */
-type ApiVersion = 1 | 2;
+type MultilingualStringEntry = {
+  text: string;
+  isPrimary: boolean;
+};
+type MultilingualStringJSON<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
+  content: Partial<Record<T[number], Array<MultilingualStringEntry>>>;
+  aliases: Array<string>;
+};
 /**
- * Represents the core data structure containing item information and metadata
+ * Options for creating and working with multilingual strings
  */
-type Data<T extends DataCategory = DataCategory, U extends DataCategory | Array<DataCategory> = (T extends "tree" ? Exclude<DataCategory, "tree"> : T extends "set" ? Array<DataCategory> : never)> = {
-  uuid: string;
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
-  };
-  publicationDateTime: Date;
-  persistentUrl: string | null;
-  item: Item<T, U>;
+type MultilingualOptions = {
+  /** Whether this string contains rich text/HTML content */isRichText?: boolean; /** Default language to use for fallbacks */
+  defaultLanguage?: string; /** Available languages for this string */
+  availableLanguages?: ReadonlyArray<string>; /** Alias values carried by OCHRE as zxx content */
+  aliases?: ReadonlyArray<string>;
 };
+type MultilingualInputContent<T extends ReadonlyArray<string>> = Partial<Record<T[number], string>>;
+type MultilingualEntriesInput<T extends ReadonlyArray<string>> = Partial<Record<T[number], ReadonlyArray<string>>>;
+/**
+ * Multilingual string
+ */
+declare class MultilingualString<T extends ReadonlyArray<string> = ReadonlyArray<string>> {
+  private readonly _content;
+  private readonly _options;
+  private readonly _availableLanguages;
+  private readonly _aliases;
+  private constructor();
+  /**
+   * Create a new multilingual string from an object of language codes to text
+   */
+  static fromObject<U extends ReadonlyArray<string>>(content: MultilingualInputContent<U>, languages: U, options?: MultilingualOptions): MultilingualString<U>;
+  static fromObject(content: Partial<Record<string, string>>, languages?: undefined, options?: MultilingualOptions): MultilingualString<ReadonlyArray<string>>;
+  /**
+   * Create a new multilingual string from language entries.
+   */
+  static fromEntries<U extends ReadonlyArray<string>>(content: MultilingualEntriesInput<U>, languages: U, options?: MultilingualOptions): MultilingualString<U>;
+  static fromEntries(content: Partial<Record<string, ReadonlyArray<string>>>, languages?: undefined, options?: MultilingualOptions): MultilingualString<ReadonlyArray<string>>;
+  /**
+   * Create a new multilingual string for a single language
+   */
+  static create<U extends ReadonlyArray<string>>(language: U[number], text: string, languages: U, options?: MultilingualOptions): MultilingualString<U>;
+  static create(language: string, text: string, languages?: undefined, options?: MultilingualOptions): MultilingualString<ReadonlyArray<string>>;
+  /**
+   * Create an empty multilingual string
+   */
+  static empty<U extends ReadonlyArray<string>>(languages: U, options?: MultilingualOptions): MultilingualString<U>;
+  static empty(languages?: undefined, options?: MultilingualOptions): MultilingualString<ReadonlyArray<string>>;
+  private getPrimaryEntry;
+  /**
+   * Get text in a specific language with automatic fallback
+   */
+  getText(language?: T[number]): string;
+  /**
+   * Get primary text in a specific language without fallback
+   */
+  getExactText(language: T[number]): string | null;
+  /**
+   * Get all text entries in a specific language without fallback
+   */
+  getExactTexts(language: T[number]): Array<string>;
+  /**
+   * Get all text entries in a specific language with fallback
+   */
+  getTexts(language?: T[number]): Array<string>;
+  /**
+   * Get all entries in a specific language without fallback
+   */
+  getExactEntries(language: T[number]): Array<MultilingualStringEntry>;
+  /**
+   * Get all entries in a specific language with fallback
+   */
+  getEntries(language?: T[number]): Array<MultilingualStringEntry>;
+  /**
+   * Get aliases carried by OCHRE as zxx content
+   */
+  getAliases(): Array<string>;
+  /**
+   * Check if text exists for a specific language
+   */
+  hasLanguage(language: T[number]): boolean;
+  /**
+   * Check if aliases exist
+   */
+  hasAliases(): boolean;
+  /**
+   * Get all available languages
+   */
+  getAvailableLanguages(): ReadonlyArray<T[number]>;
+  /**
+   * Get all supported languages (the full language array passed to constructor)
+   */
+  getSupportedLanguages(): T;
+  /**
+   * Check if the multilingual string is empty (no content in any language)
+   */
+  isEmpty(): boolean;
+  /**
+   * Check if the multilingual string has any content
+   */
+  hasContent(): boolean;
+  /**
+   * Get the default language
+   */
+  getDefaultLanguage(): T[number];
+  /**
+   * Check if this string contains rich text
+   */
+  isRichText(): boolean;
+  /**
+   * Add or update the primary text for a language (returns new instance)
+   */
+  withText(language: T[number], text: string): MultilingualString<T>;
+  /**
+   * Add another text entry for a language (returns new instance)
+   */
+  withEntry(language: T[number], text: string): MultilingualString<T>;
+  /**
+   * Replace aliases (returns new instance)
+   */
+  withAliases(aliases: ReadonlyArray<string>): MultilingualString<T>;
+  /**
+   * Remove text for a language (returns new instance)
+   */
+  withoutLanguage(language: T[number]): MultilingualString<T>;
+  /**
+   * Transform all language versions (returns new instance)
+   */
+  map(fn: (text: string, language: T[number]) => string): MultilingualString<T>;
+  /**
+   * Filter languages based on predicate (returns new instance)
+   */
+  filter(predicate: (text: string, language: T[number]) => boolean): MultilingualString<T>;
+  /**
+   * Get the string representation (uses default language)
+   */
+  toString(): string;
+  /**
+   * Get JSON representation
+   */
+  toJSON(): MultilingualStringJSON<T>;
+}
+//#endregion
+//#region src/types/index.d.ts
+type Prettify<T> = { [K in keyof T]: T[K] } & {};
 /**
- * Represents the category of the data
+ * The category of an item in OCHRE
  */
-type DataCategory = "resource" | "spatialUnit" | "concept" | "period" | "bibliography" | "person" | "propertyVariable" | "propertyValue" | "text" | "tree" | "set";
+type DataCategory = "tree" | "bibliography" | "concept" | "spatialUnit" | "period" | "person" | "propertyVariable" | "propertyValue" | "resource" | "text" | "set";
+type HierarchyDataCategory = Extract<DataCategory, "tree" | "set">;
 /**
- * Represents the item of the data, with proper type narrowing based on category
+ * The category of items in a Tree
  */
-type Item<T extends DataCategory = DataCategory, U extends DataCategory | Array<DataCategory> = (T extends "tree" ? Exclude<DataCategory, "tree"> : T extends "set" ? Array<DataCategory> : never)> = T extends "resource" ? Resource : T extends "spatialUnit" ? SpatialUnit : T extends "concept" ? Concept : T extends "period" ? Period : T extends "bibliography" ? Bibliography : T extends "person" ? Person : T extends "propertyVariable" ? PropertyVariable : T extends "propertyValue" ? PropertyValue : T extends "text" ? Text : T extends "tree" ? Tree<U extends Array<DataCategory> ? Exclude<U[number], "tree"> : Exclude<U, "tree">> : T extends "set" ? Set<U extends Array<DataCategory> ? U : Array<U>> : Resource | SpatialUnit | Concept | Period | Bibliography | Person | PropertyVariable | PropertyValue | Tree<U extends Array<DataCategory> ? Exclude<U[number], "tree"> : Exclude<U, "tree">> | Set<U extends Array<DataCategory> ? U : Array<U>>;
+type ItemsDataCategory = Exclude<DataCategory, "tree">;
 /**
- * Basic identification information used across multiple types
+ * The category of items in a Set
  */
-type Identification = {
-  label: string;
-  abbreviation: string;
+type SetItemDataCategory = DataCategory;
+type HierarchyItemDataCategory<U extends DataCategory> = U extends "tree" ? ItemsDataCategory : U extends "set" ? SetItemDataCategory : never;
+type HierarchyItemCategoryOption<U extends DataCategory> = U extends "tree" ? ItemsDataCategory : U extends "set" ? SetItemDataCategory | ReadonlyArray<SetItemDataCategory> : never;
+type HierarchyItemCategoryFromOption<U extends DataCategory, V extends HierarchyItemCategoryOption<U> | undefined> = V extends ReadonlyArray<infer W> ? Extract<W, HierarchyItemDataCategory<U>> : V extends HierarchyItemDataCategory<U> ? V : HierarchyItemDataCategory<U>;
+/**
+ * The category of items in a heading
+ */
+type HeadingDataCategory = Exclude<DataCategory, "tree" | "bibliography" | "spatialUnit" | "concept" | "period">;
+/**
+ * The category of items that are in hierarchies (tree or set)
+ */
+type RecursiveDataCategory = Exclude<DataCategory, "tree" | "person" | "propertyVariable" | "propertyValue" | "set">;
+/**
+ *  The category names that can appear in OCHRE context paths
+ */
+type ContextDataCategory = Exclude<DataCategory, "tree" | "person" | "set">;
+/**
+ *  Basic identification information
+ */
+type Identification<T extends ReadonlyArray<string>> = {
+  label: MultilingualString<T>;
+  abbreviation: MultilingualString<T> | null;
   code: string | null;
+  email: string | null;
+  website: string | null;
 };
 /**
- * Metadata information for items including project, publisher and language details
+ *  Metadata in OCHRE
  */
-type Metadata = {
+type Metadata<T extends ReadonlyArray<string>> = {
+  dataset: string;
+  description: string;
+  publisher: string;
+  identifier: string;
   project: {
     uuid: string;
-    identification: Identification & {
-      website: string | null;
-    };
+    identification: Identification<T>;
+    website: string | null;
     dateFormat: string | null;
     page: "item" | "entry" | null;
   } | null;
   collection: {
     uuid: string;
-    identification: Identification;
+    identification: Identification<T>;
     page: "item" | "entry";
   } | null;
   publication: {
     uuid: string;
-    identification: Identification;
+    identification: Identification<T>;
     page: "item" | "entry";
   } | null;
   item: {
-    identification: Identification;
+    identification: Identification<T>;
     category: string;
     type: string;
     maxLength: number | null;
   } | null;
-  dataset: string;
-  publisher: string;
-  languages: Array<string>;
-  identifier: string;
-  description: string;
+  defaultLanguage: T[number];
+  languages: T;
 };
-/**
- * Represents a single item in a context hierarchy with its metadata
- */
-type ContextItem = {
+type BelongsTo = {
   uuid: string;
-  publicationDateTime: Date | null;
-  number: number;
-  content: string;
-};
-/**
- * Represents a node in the context tree containing tree, project and spatial unit information
- */
-type ContextNode = {
-  tree: ContextItem;
-  project: ContextItem;
-  spatialUnit: Array<ContextItem>;
+  abbreviation: string;
 };
-/**
- * Contains the full context information including nodes and display path
- */
-type Context = {
-  nodes: Array<ContextNode>;
-  displayPath: string;
+type ItemLocation = "topLevel" | "nested";
+type ItemOrigin<T extends ReadonlyArray<string>, U extends ItemLocation> = U extends "topLevel" ? {
+  belongsTo: BelongsTo;
+  metadata: Metadata<T>;
+  persistentUrl: string | null;
+} : {
+  belongsTo: null;
+  metadata: null;
+  persistentUrl: null;
 };
 /**
- * License information for content items
+ *  License in OCHRE
  */
 type License = {
   content: string;
-  url: string;
+  target: string | null;
 };
 /**
- * Represents a person (author, creator, etc.) with their identification and metadata
+ *  Context item in OCHRE
  */
-type Person = {
-  uuid: string;
-  category: "person";
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
-  } | null;
-  metadata: Metadata | null;
+type ContextItem = {
+  uuid: string | null;
   publicationDateTime: Date | null;
-  persistentUrl: string | null;
-  type: string | null;
-  number: number | null;
-  context: Context | null;
-  availability: License | null;
-  date: string | null;
-  identification: Identification | null;
-  image: Image | null;
-  address: {
-    country: string | null;
-    city: string | null;
-    state: string | null;
-  } | null;
-  description: string | null;
-  coordinates: Array<Coordinate>;
-  content: string | null;
-  notes: Array<Note>;
-  links: Array<Link>;
-  events: Array<Event>;
-  properties: Array<Property>;
-  bibliographies: Array<Bibliography>;
-};
-/**
- * Represents a note with number, title and content
- */
-type Note = {
-  number: number;
-  title: string | null;
-  date: string | null;
-  authors: Array<Person>;
+  index: number;
   content: string;
 };
 /**
- * Represents an image with its metadata and content
+ *  Context node in OCHRE
  */
-type Image = {
-  publicationDateTime: Date | null;
-  identification: Identification | null;
-  url: string | null;
-  htmlPrefix: string | null;
-  content: string | null;
-  widthPreview: number | null;
-  heightPreview: number | null;
-  width: number | null;
-  height: number | null;
-};
+type ContextNode<U extends ContextDataCategory> = {
+  tree: ContextItem;
+  project: ContextItem;
+  heading: Array<ContextItem>;
+} & Partial<Record<U, Array<ContextItem>>>;
 /**
- * Represents a file format
+ *  Context in OCHRE
  */
-type FileFormat = "image/jpeg" | "image/gif" | "image/tiff" | "image/bmp" | "image/png" | "image/svg+xml" | "image/vnd.microsoft.icon" | "image/jpeg-imageMap" | "image/gif-imageMap" | "image/tiff-imageMap" | "image/bmp-imageMap" | "image/png-imageMap" | "image/svg+xml-imageMap" | "video/mpeg" | "video/mp4" | "video/quicktime" | "video/x-msvideo" | "video/x-ms-wmv" | "video/x-ms-asf" | "drawing/dwg" | "audio/aiff" | "audio/basic" | "audio/midi" | "audio/mp4" | "audio/mpeg" | "audio/x-ms-wax" | "audio/x-ms-wma" | "audio/wav" | "text/pdf" | "text/doc" | "text/ppt" | "text/html" | "text/plain" | "application/xls" | "application/xlsx" | "application/ai" | "application/octet-stream" | "application/IIIF" | "image/fits" | "image/ptm" | "model/obj";
+type Context<U extends ContextDataCategory> = {
+  nodes: Array<ContextNode<U>>;
+  displayPath: string;
+};
 /**
- * Represents a link to another item with optional image and bibliographic references
+ *  Event in OCHRE
  */
-type Link = {
-  uuid: string | null;
-  publicationDateTime: Date | null;
-  type: string | null;
-  category: string | null;
-  identification: Identification | null;
-  description: string | null;
-  content: string | null;
-  href: string | null;
-  fileFormat: FileFormat | null;
-  fileSize: number | null;
-  image: {
-    isInline: boolean;
-    isPrimary: boolean;
-    heightPreview: number;
-    widthPreview: number;
-    height: number;
-    width: number;
+type Event<T extends ReadonlyArray<string>> = {
+  date: Date | {
+    start: Date;
+    end: Date;
+  } | null;
+  label: MultilingualString<T>;
+  comment: string | null;
+  agent: {
+    uuid: string;
+    label: MultilingualString<T>;
+    publicationDateTime: Date | null;
+  } | null;
+  location: {
+    uuid: string;
+    label: MultilingualString<T>;
+    publicationDateTime: Date | null;
+  } | null;
+  other: {
+    uuid: string | null;
+    category: string | null;
+    label: MultilingualString<T>;
   } | null;
-  bibliographies: Array<Bibliography> | null;
 };
 /**
- * Represents a clickable/interactive area on an image map
+ *  Source of coordinates in OCHRE
  */
-type ImageMapArea = {
+type CoordinatesSource<T extends ReadonlyArray<string>> = {
+  context: "self";
   uuid: string;
-  publicationDateTime: Date | null;
-  category: string;
-  title: string;
-  shape: "rectangle" | "circle" | "polygon";
-  coords: Array<number>;
-  slug: string | null;
-};
-/**
- * Contains image map areas and dimensions
- */
-type ImageMap = {
-  area: Array<ImageMapArea>;
-  width: number;
-  height: number;
+  label: MultilingualString<T>;
+} | {
+  context: "related";
+  uuid: string;
+  label: MultilingualString<T>;
+  value: MultilingualString<T>;
+} | {
+  context: "inherited";
+  item: {
+    uuid: string | null;
+    label: MultilingualString<T>;
+  };
+  uuid: string;
+  label: MultilingualString<T>;
 };
 /**
- * Geographic coordinate with optional type and label
+ *  Coordinates in OCHRE
  */
-type Coordinate = {
+type Coordinates<T extends ReadonlyArray<string>> = {
   type: "point";
   latitude: number;
   longitude: number;
   altitude: number | null;
-  source: {
-    context: "self";
-    uuid: string;
-    label: string;
-  } | {
-    context: "related";
-    uuid: string;
-    label: string;
-    value: string;
-  } | {
-    context: "inherited";
-    item: {
-      uuid: string;
-      label: string;
-    };
-    uuid: string;
-    label: string;
-  } | null;
+  source: CoordinatesSource<T> | null;
 } | {
   type: "plane";
   minimum: {
@@ -239,400 +331,474 @@ type Coordinate = {
     latitude: number;
     longitude: number;
   };
-  source: {
-    context: "self";
-    uuid: string;
-    label: string;
-  } | {
-    context: "related";
-    uuid: string;
-    label: string;
-    value: string;
-  } | {
-    context: "inherited";
-    item: {
-      uuid: string;
-      label: string;
-    };
-    uuid: string;
-    label: string;
-  } | null;
+  source: CoordinatesSource<T> | null;
 };
 /**
- * Represents an observation with notes, links and properties
+ *  Image in OCHRE
  */
-type Observation = {
-  number: number;
-  date: string | null;
-  observers: Array<string> | Array<Person>;
-  notes: Array<Note>;
-  links: Array<Link>;
-  properties: Array<Property>;
-  bibliographies: Array<Bibliography>;
+type Image<T extends ReadonlyArray<string>> = {
+  publicationDateTime: Date | null;
+  identification: Identification<T> | null;
+  href: string | null;
+  htmlImgSrcPrefix: string | null;
+  height: number | null;
+  width: number | null;
+  fileSize: number | null;
+  base64: string | null;
 };
 /**
- * Represents an event with date, label and optional agent
+ *  Area of an image map in OCHRE
  */
-type Event = {
-  dateTime: string | null;
-  label: string;
-  agent: {
-    uuid: string;
-    publicationDateTime: Date | null;
-    content: string;
-  } | null;
-  location: {
-    uuid: string;
-    publicationDateTime: Date | null;
-    content: string;
-  } | null;
-  comment: string | null;
-  other: {
-    uuid: string | null;
-    category: string | null;
-    content: string;
-  } | null;
-  value: string | null;
+type ImageMapArea = {
+  uuid: string;
+  publicationDateTime: Date | null;
+  type: string;
+  title: string;
+  items: Array<{
+    shape: "rectangle";
+    coords: [number, number, number, number];
+  } | {
+    shape: "circle";
+    center: {
+      x: number;
+      y: number;
+    };
+    radius: number;
+  } | {
+    shape: "polygon";
+    coords: Array<number>;
+  }>;
 };
 /**
- * Represents an interpretation with date and properties
+ *  Image map in OCHRE
  */
-type Interpretation = {
-  date: string | null;
+type ImageMap = {
+  areas: Array<ImageMapArea>;
+  width: number;
+  height: number;
+};
+/**
+ *  Note in OCHRE
+ */
+type Note<T extends ReadonlyArray<string>> = {
   number: number;
-  notes: Array<Note>;
-  links: Array<Link>;
-  properties: Array<Property>;
-  bibliographies: Array<Bibliography>;
+  title: string | null;
+  content: MultilingualString<T>;
+  authors: Array<Person<T, "nested">>;
 };
 /**
- * Represents a resource item with associated metadata, content and relationships
+ *  Property value content in OCHRE
  */
-type Resource = {
-  uuid: string;
-  category: "resource";
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
-  } | null;
-  metadata: Metadata | null;
+type PropertyValueContent<T extends ReadonlyArray<string>> = Prettify<{
+  hierarchy: {
+    isLeaf: boolean;
+    level: number | null;
+  };
+  label: MultilingualString<T> | null;
+  isUncertain: boolean;
+  category: string | null;
+  type: string | null;
+  uuid: string | null;
   publicationDateTime: Date | null;
-  persistentUrl: string | null;
-  type: string;
-  number: number;
-  context: Context | null;
-  license: License | null;
-  copyright: string | null;
-  watermark: string | null;
-  identification: Identification;
-  date: string | null;
-  image: Image | null;
-  creators: Array<Person>;
-  notes: Array<Note>;
-  description: string;
-  coordinates: Array<Coordinate>;
-  document: string | null;
+  unit: string | null;
   href: string | null;
-  fileFormat: FileFormat | null;
+  height: number | null;
+  width: number | null;
   fileSize: number | null;
-  imageMap: ImageMap | null;
-  periods: Array<Period>;
-  links: Array<Link>;
-  reverseLinks: Array<Link>;
-  properties: Array<Property>;
-  bibliographies: Array<Bibliography>;
-  resources: Array<Resource>;
-};
+  slug: string | null;
+} & ({
+  dataType: "string" | "coordinate" | "IDREF" | "date" | "dateTime";
+  content: string;
+} | {
+  dataType: "integer" | "decimal" | "time";
+  content: number;
+} | {
+  dataType: "boolean";
+  content: boolean;
+})>;
 /**
- * Represents a spatial unit with geographic coordinates and observations
+ *  Property in OCHRE
  */
-type SpatialUnit = {
-  uuid: string;
-  category: "spatialUnit";
-  belongsTo: {
+type Property<T extends ReadonlyArray<string>> = {
+  label: {
     uuid: string;
-    abbreviation: string;
-  } | null;
-  metadata: Metadata | null;
-  publicationDateTime: Date | null;
-  persistentUrl: string | null;
-  number: number;
-  context: Context | null;
-  license: License | null;
-  identification: Identification;
-  image: Image | null;
-  description: string | null;
-  coordinates: Array<Coordinate>;
-  mapData: {
-    geoJSON: {
-      multiPolygon: string;
-      EPSG: number;
-    };
-  } | null;
-  observations: Array<Observation>;
-  events: Array<Event>;
-  properties: Array<Property>;
-  bibliographies: Array<Bibliography>;
+    publicationDateTime: Date | null;
+    name: string;
+  };
+  values: Array<PropertyValueContent<T>>;
+  comment: MultilingualString<T> | null;
+  properties: Array<Property<T>>;
 };
 /**
- * Represents a concept with associated interpretations
+ *  Property in a Set item. OCHRE exposes Set item properties as a flat list.
  */
-type Concept = {
+type SingleHierarchyProperty<T extends ReadonlyArray<string>> = Omit<Property<T>, "properties">;
+type WithSingleHierarchyProperties<U extends {
+  properties: Array<Property<T>>;
+}, T extends ReadonlyArray<string>> = U extends {
+  properties: Array<Property<T>>;
+} ? Prettify<Omit<U, "properties"> & {
+  properties: Array<SingleHierarchyProperty<T>>;
+}> : never;
+/**
+ *  Base item in OCHRE
+ */
+type BaseItem<U extends DataCategory = DataCategory, T extends ReadonlyArray<string> = ReadonlyArray<string>, V extends ItemLocation = "topLevel"> = ItemOrigin<T, V> & {
   uuid: string;
-  category: "concept";
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
-  } | null;
-  metadata: Metadata | null;
+  category: U;
   publicationDateTime: Date | null;
-  persistentUrl: string | null;
-  number: number;
+  context: Context<ContextDataCategory> | null;
+  date: Date | null;
   license: License | null;
-  context: Context | null;
-  identification: Identification;
-  status: "live" | "pending";
-  image: Image | null;
-  description: string | null;
-  coordinates: Array<Coordinate>;
-  interpretations: Array<Interpretation>;
-  properties: Array<Property>;
-  bibliographies: Array<Bibliography>;
+  copyright: MultilingualString<T> | null;
+  watermark: MultilingualString<T> | null;
+  identification: Identification<T>;
+  creators: Array<Person<T, "nested">>;
+  description: MultilingualString<T> | null;
+  events: Array<Event<T>>;
 };
+type ItemLinkCategory = DataCategory | "dictionaryUnit";
 /**
- * Represents a set that can contain resources, spatial units and concepts
+ *  Base item data exposed by OCHRE link and reverse-link payloads.
  */
-type Set<U extends Array<DataCategory> = Array<DataCategory>> = {
+type BaseItemLink<U extends ItemLinkCategory = ItemLinkCategory, T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   uuid: string;
-  category: "set";
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
-  } | null;
-  metadata: Metadata | null;
-  itemCategories: U;
+  category: U;
   publicationDateTime: Date | null;
-  persistentUrl: string | null;
-  type: string;
-  number: number;
-  date: string | null;
-  license: License | null;
-  identification: Identification;
-  isSuppressingBlanks: boolean;
-  description: string;
-  creators: Array<Person>;
-  items: [DataCategory] extends [U] ? Array<Item> : U extends "resource" ? Array<Resource> : U extends "spatialUnit" ? Array<SpatialUnit> : U extends "concept" ? Array<Concept> : U extends "period" ? Array<Period> : U extends "bibliography" ? Array<Bibliography> : U extends "person" ? Array<Person> : U extends "propertyVariable" ? Array<PropertyVariable> : U extends "propertyValue" ? Array<PropertyValue> : U extends "tree" ? Array<Tree<Exclude<DataCategory, "tree">>> : U extends "set" ? Array<Set<Array<DataCategory>>> : Array<Item>;
+  context: Context<ContextDataCategory> | null;
+  date: Date | null;
+  identification: Identification<T>;
+  description: MultilingualString<T> | null;
 };
-/**
- * Represents a bibliography entry with citation and publication information
- */
-type Bibliography = {
-  uuid: string | null;
-  zoteroId: string | null;
-  category: "bibliography";
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
-  } | null;
-  metadata: Metadata | null;
+type BibliographySourceDocument = {
+  uuid: string;
+  content: string;
+  href: string | null;
   publicationDateTime: Date | null;
-  persistentUrl: string | null;
+};
+type BibliographyEntryInfo = {
+  content: string | null;
+  startIssue: string;
+  startVolume: string;
+  startPage: string;
+  endPage: string;
+};
+type ItemLinks<T extends ReadonlyArray<string> = ReadonlyArray<string>> = Array<ItemLink<ItemLinkCategory, T>>;
+type TreeItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"tree", T> & {
   type: string | null;
-  number: number | null;
-  identification: Identification | null;
-  projectIdentification: Identification | null;
-  context: Context | null;
-  image: Image | null;
-  citation: {
-    details: string | null;
-    format: string | null;
-    short: string | null;
-    long: string | null;
-  };
+  itemsCategory: ItemsDataCategory | null;
+}>;
+type SetItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"set", T> & {
+  type: string | null;
+  itemsCategory: Array<SetItemDataCategory> | null;
+}>;
+type BibliographyItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"bibliography", T> & {
+  type: string | null;
+  zoteroId: string | null;
+  citationDetails: string | null;
+  citationFormat: MultilingualString<T> | null;
+  citationFormatSpan: string | null;
+  referenceFormatDiv: string | null;
+  image: Image<T> | null;
+  sourceDocument: BibliographySourceDocument | null;
   publicationInfo: {
-    publishers: Array<Person>;
+    publishers: Array<ItemLink<"person", T>>;
     startDate: Date | null;
-  };
-  entryInfo: {
-    startIssue: string;
-    startVolume: string;
   } | null;
-  sourceResources: Array<Pick<Resource, "uuid" | "category" | "publicationDateTime" | "type" | "identification" | "href">>;
-  periods: Array<Period>;
-  authors: Array<Person>;
-  links: Array<Link>;
-  reverseLinks: Array<Link>;
-  properties: Array<Property>;
+  entryInfo: BibliographyEntryInfo | null;
+  source: ItemLink<ItemsDataCategory, T> | null;
+  authors: Array<ItemLink<"person", T>>;
+  periods: Array<ItemLink<"period", T>>;
+  properties: Array<Property<T>>;
+}>;
+type ConceptItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"concept", T> & {
+  image: Image<T> | null;
+  coordinates: Array<Coordinates<T>>;
+}>;
+type SpatialUnitItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"spatialUnit", T> & {
+  image: Image<T> | null;
+  coordinates: Array<Coordinates<T>>;
+}>;
+type PeriodItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"period", T> & {
+  type: string | null;
+  coordinates: Array<Coordinates<T>>;
+}>;
+type PersonItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"person", T> & {
+  type: string | null;
+  coordinates: Array<Coordinates<T>>;
+}>;
+type PropertyVariableItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"propertyVariable", T> & {
+  type: string | null;
+  coordinates: Array<Coordinates<T>>;
+}>;
+type PropertyValueItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"propertyValue", T> & {
+  coordinates: Array<Coordinates<T>>;
+}>;
+type ResourceItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"resource", T> & {
+  type: string | null;
+  href: string | null;
+  fileFormat: string | null;
+  fileSize: number | null;
+  isInline: boolean;
+  isPrimary: boolean;
+  height: number | null;
+  width: number | null;
+  image: Image<T> | null;
+  coordinates: Array<Coordinates<T>>;
+}>;
+type TextItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"text", T> & {
+  type: string | null;
+  text: string | null;
+  language: string | null;
+  image: Image<T> | null;
+  coordinates: Array<Coordinates<T>>;
+}>;
+type DictionaryUnitItemLink<T extends ReadonlyArray<string>> = Prettify<BaseItemLink<"dictionaryUnit", T>>;
+/**
+ * An abridged item reference exposed inside OCHRE links and reverse links.
+ */
+type ItemLink<U extends ItemLinkCategory = ItemLinkCategory, T extends ReadonlyArray<string> = ReadonlyArray<string>> = U extends ItemLinkCategory ? U extends "tree" ? TreeItemLink<T> : U extends "set" ? SetItemLink<T> : U extends "bibliography" ? BibliographyItemLink<T> : U extends "concept" ? ConceptItemLink<T> : U extends "spatialUnit" ? SpatialUnitItemLink<T> : U extends "period" ? PeriodItemLink<T> : U extends "person" ? PersonItemLink<T> : U extends "propertyVariable" ? PropertyVariableItemLink<T> : U extends "propertyValue" ? PropertyValueItemLink<T> : U extends "resource" ? ResourceItemLink<T> : U extends "text" ? TextItemLink<T> : U extends "dictionaryUnit" ? DictionaryUnitItemLink<T> : never : never;
+/**
+ * An Item in OCHRE (can be a tree, set, bibliography, concept, spatial unit, period, person, property value, property variable, or resource)
+ */
+type Item<U extends DataCategory = DataCategory, V extends HierarchyItemDataCategory<U> = HierarchyItemDataCategory<U>, T extends ReadonlyArray<string> = ReadonlyArray<string>, W extends ItemLocation = "topLevel"> = U extends DataCategory ? U extends "tree" ? Tree<Extract<V, ItemsDataCategory>, T, W> : U extends "set" ? Set<Extract<V, SetItemDataCategory>, T, W> : U extends "bibliography" ? Bibliography<T, W> : U extends "concept" ? Concept<T, W> : U extends "spatialUnit" ? SpatialUnit<T, W> : U extends "period" ? Period<T, W> : U extends "person" ? Person<T, W> : U extends "propertyVariable" ? PropertyVariable<T, W> : U extends "propertyValue" ? PropertyValue<T, W> : U extends "resource" ? Resource<T, W> : U extends "text" ? Text<T, W> : never : never;
+/**
+ *  Heading in OCHRE
+ */
+type Heading<U extends HeadingDataCategory, T extends ReadonlyArray<string>> = {
+  name: string;
+  headings: Array<Heading<U, T>>;
+  items: Array<Item<U, never, T, "nested">>;
 };
 /**
- * Represents a time period with identification
+ *  Tree in OCHRE
  */
-type Period = {
-  uuid: string;
-  category: "period";
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
+type Tree<U extends ItemsDataCategory, T extends ReadonlyArray<string>, V extends ItemLocation = "topLevel"> = Prettify<BaseItem<"tree", T, V> & {
+  type: string | null;
+  itemsCategory: U | null;
+  links: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  properties: Array<Property<T>>;
+  bibliographies: Array<Bibliography<T, "nested">>;
+  items: U extends HeadingDataCategory ? Array<Heading<U, T> | Item<U, never, T, "nested">> : Array<Item<U, never, T, "nested">>;
+}>;
+/**
+ *  Set in OCHRE
+ */
+type Set<U extends SetItemDataCategory, T extends ReadonlyArray<string>, V extends ItemLocation = "topLevel"> = Prettify<BaseItem<"set", T, V> & {
+  itemsCategory: Array<U>;
+  isTabularStructure: boolean;
+  isSuppressingBlanks: boolean;
+  links: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  properties: Array<Property<T>>;
+  items: Array<SetItem<U, T>>;
+}>;
+type SetBibliography<T extends ReadonlyArray<string>> = Bibliography<T, "nested"> extends infer U ? U extends {
+  properties: Array<Property<T>>;
+} ? Prettify<Omit<U, "properties" | "items"> & {
+  properties: Array<SingleHierarchyProperty<T>>;
+}> : never : never;
+type SetConcept<T extends ReadonlyArray<string>> = Prettify<Omit<Concept<T, "nested">, "interpretations" | "items"> & {
+  properties: Array<SingleHierarchyProperty<T>>;
+}>;
+type SetSpatialUnit<T extends ReadonlyArray<string>> = Prettify<Omit<SpatialUnit<T, "nested">, "observations" | "items"> & {
+  properties: Array<SingleHierarchyProperty<T>>;
+}>;
+type SetPeriod<T extends ReadonlyArray<string>> = Prettify<Omit<WithSingleHierarchyProperties<Period<T, "nested">, T>, "items">>;
+type SetResource<T extends ReadonlyArray<string>> = Prettify<Omit<WithSingleHierarchyProperties<Resource<T, "nested">, T>, "items">>;
+type SetTree<T extends ReadonlyArray<string>> = Prettify<Omit<WithSingleHierarchyProperties<Tree<ItemsDataCategory, T, "nested">, T>, "items">>;
+type SetItem<U extends SetItemDataCategory, T extends ReadonlyArray<string>> = U extends "tree" ? SetTree<T> : U extends "bibliography" ? SetBibliography<T> : U extends "concept" ? SetConcept<T> : U extends "spatialUnit" ? SetSpatialUnit<T> : U extends "period" ? SetPeriod<T> : U extends "person" ? WithSingleHierarchyProperties<Person<T, "nested">, T> : U extends "propertyVariable" ? PropertyVariable<T, "nested"> : U extends "propertyValue" ? WithSingleHierarchyProperties<PropertyValue<T, "nested">, T> : U extends "resource" ? SetResource<T> : U extends "text" ? Text<T, "nested"> : U extends "set" ? Omit<WithSingleHierarchyProperties<Set<SetItemDataCategory, T, "nested">, T>, "items"> : never;
+/**
+ *  Person in OCHRE
+ */
+type Person<T extends ReadonlyArray<string>, U extends ItemLocation = "topLevel"> = Prettify<BaseItem<"person", T, U> & {
+  type: string;
+  image: Image<T> | null;
+  address: {
+    country: string | null;
+    city: string | null;
+    state: string | null;
+    postalCode: string | null;
   } | null;
-  metadata: Metadata | null;
-  publicationDateTime: Date | null;
-  persistentUrl: string | null;
+  coordinates: Array<Coordinates<T>>;
+  content: MultilingualString<T> | null;
+  periods: Array<Period<T, "nested">>;
+  links: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  properties: Array<Property<T>>;
+}>;
+/**
+ *  Period in OCHRE
+ */
+type Period<T extends ReadonlyArray<string>, U extends ItemLocation = "topLevel"> = Prettify<BaseItem<"period", T, U> & {
   type: string | null;
-  number: number | null;
-  identification: Identification;
-  coordinates: Array<Coordinate>;
-  description: string | null;
-};
+  coordinates: Array<Coordinates<T>>;
+  links: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  properties: Array<Property<T>>;
+  bibliographies: Array<Bibliography<T, "nested">>;
+  items: Array<Period<T, "nested">>;
+}>;
 /**
- * Represents a property variable
+ *  Bibliography in OCHRE
  */
-type PropertyVariable = {
-  uuid: string;
-  category: "propertyVariable";
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
+type Bibliography<T extends ReadonlyArray<string>, U extends ItemLocation = "topLevel"> = Prettify<BaseItem<"bibliography", T, U> & {
+  citationDetails: string | null;
+  citationFormat: MultilingualString<T> | null;
+  citationFormatSpan: string | null;
+  referenceFormatDiv: string | null;
+  image: Image<T> | null;
+  sourceDocument: BibliographySourceDocument | null;
+  publicationInfo: {
+    publishers: Array<Person<T, "nested">>;
+    startDate: Date | null;
   } | null;
-  metadata: Metadata | null;
-  persistentUrl: string | null;
-  type: string;
+  entryInfo: BibliographyEntryInfo | null;
+  source: ItemLink<ItemsDataCategory, T> | null;
+  authors: Array<Person<T, "nested">>;
+  periods: Array<Period<T, "nested">>;
+  links: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  properties: Array<Property<T>>;
+  bibliographies: Array<Bibliography<T, "nested">>;
+  items: Array<Bibliography<T, "nested">>;
+} & ({
+  type: "zotero";
+  zoteroId: string;
+  uuid: string | null;
+} | {
+  type: string | null;
+})>;
+/**
+ *  Concept in OCHRE
+ */
+type Concept<T extends ReadonlyArray<string>, U extends ItemLocation = "topLevel"> = Prettify<BaseItem<"concept", T, U> & {
+  image: Image<T> | null;
+  interpretations: Array<Interpretation<T>>;
+  coordinates: Array<Coordinates<T>>;
+  items: Array<Concept<T, "nested">>;
+}>;
+/**
+ *  Interpretation in OCHRE
+ */
+type Interpretation<T extends ReadonlyArray<string>> = {
   number: number;
-  publicationDateTime: Date | null;
-  context: Context | null;
-  availability: License | null;
-  identification: Identification;
+  date: Date | null;
+  observers: Array<Person<T, "nested">>;
+  periods: Array<Period<T, "nested">>;
+  links: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  properties: Array<Property<T>>;
+  bibliographies: Array<Bibliography<T, "nested">>;
 };
 /**
- * Represents a property value with type information
+ *  Spatial unit in OCHRE
  */
-type PropertyValue = {
-  uuid: string;
-  category: "propertyValue";
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
+type SpatialUnit<T extends ReadonlyArray<string>, U extends ItemLocation = "topLevel"> = Prettify<BaseItem<"spatialUnit", T, U> & {
+  image: Image<T> | null;
+  coordinates: Array<Coordinates<T>>;
+  mapData: {
+    geoJSON: {
+      multiPolygon: string;
+      EPSG: number;
+    };
   } | null;
-  metadata: Metadata | null;
-  persistentUrl: string | null;
+  observations: Array<Observation<T>>;
+  bibliographies: Array<Bibliography<T, "nested">>;
+  items: Array<SpatialUnit<T, "nested">>;
+}>;
+/**
+ *  Observation in OCHRE
+ */
+type Observation<T extends ReadonlyArray<string>> = {
   number: number;
-  publicationDateTime: Date | null;
-  context: Context | null;
-  availability: License | null;
-  identification: Identification;
-  date: string | null;
-  creators: Array<Person>;
-  description: string;
-  coordinates: Array<Coordinate>;
-  notes: Array<Note>;
-  links: Array<Link>;
+  date: Date | null;
+  observers: Array<string> | Array<Person<T, "nested">>;
+  periods: Array<Period<T, "nested">>;
+  links: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  properties: Array<Property<T>>;
+  bibliographies: Array<Bibliography<T, "nested">>;
 };
-type PropertyValueContentType = "string" | "integer" | "decimal" | "boolean" | "date" | "dateTime" | "time" | "coordinate" | "IDREF";
 /**
- * Represents a property value with type information
+ *  Property variable in OCHRE
  */
-type PropertyValueContent<T extends PropertyValueContentType> = {
-  hierarchy: {
-    isLeaf: boolean;
-    level: number | null;
-  };
-  content: (T extends "integer" ? number : T extends "decimal" ? number : T extends "time" ? number : T extends "boolean" ? boolean : string) | null;
-  dataType: T;
-  label: string | null;
-  isUncertain: boolean;
-  unit: string | null;
-  height: number | null;
-  width: number | null;
-  fileSize: number | null;
-  category: string | null;
+type PropertyVariable<T extends ReadonlyArray<string>, U extends ItemLocation = "topLevel"> = Prettify<BaseItem<"propertyVariable", T, U> & {
   type: string | null;
-  uuid: string | null;
-  publicationDateTime: Date | null;
-  href: string | null;
-  slug: string | null;
-};
+  coordinates: Array<Coordinates<T>>;
+  links: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  bibliographies: Array<Bibliography<T, "nested">>;
+}>;
 /**
- * Represents a property with label, values and nested properties
+ *  Property value in OCHRE
  */
-type Property<T extends PropertyValueContentType = PropertyValueContentType> = {
-  uuid: string;
-  label: string;
-  values: Array<PropertyValueContent<T>>;
-  comment: string | null;
-  properties: Array<Property>;
-};
+type PropertyValue<T extends ReadonlyArray<string>, U extends ItemLocation = "topLevel"> = Prettify<BaseItem<"propertyValue", T, U> & {
+  coordinates: Array<Coordinates<T>>;
+  links: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  properties: Array<Property<T>>;
+  bibliographies: Array<Bibliography<T, "nested">>;
+}>;
 /**
- * Represents a resource item with associated metadata, content and relationships
+ *  Resource in OCHRE
  */
-type Text = {
-  uuid: string;
-  category: "text";
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
-  } | null;
-  metadata: Metadata | null;
-  publicationDateTime: Date | null;
-  persistentUrl: string | null;
-  type: string | null;
-  language: string | null;
-  number: number;
-  context: Context | null;
-  license: License | null;
-  copyright: string | null;
-  watermark: string | null;
-  identification: Identification;
-  image: Image | null;
-  creators: Array<Person>;
-  editors: Array<Person>;
-  notes: Array<Note>;
-  description: string;
-  coordinates: Array<Coordinate>;
-  periods: Array<Period>;
-  links: Array<Link>;
-  reverseLinks: Array<Link>;
-  properties: Array<Property>;
-  bibliographies: Array<Bibliography>;
-  sections: Array<Section>;
-};
+type Resource<T extends ReadonlyArray<string>, U extends ItemLocation = "topLevel"> = Prettify<BaseItem<"resource", T, U> & {
+  type: string;
+  href: string | null;
+  fileFormat: string | null;
+  fileSize: number | null;
+  isInline: boolean;
+  height: number | null;
+  width: number | null;
+  image: Image<T> | null;
+  document: MultilingualString<T> | null;
+  imageMap: ImageMap | null;
+  coordinates: Array<Coordinates<T>>;
+  periods: Array<Period<T, "nested">>;
+  links: ItemLinks<T>;
+  reverseLinks: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  properties: Array<Property<T>>;
+  bibliographies: Array<Bibliography<T, "nested">>;
+  items: Array<Resource<T, "nested">>;
+}>;
 /**
- * Represents a section of a text
+ *  Text in OCHRE
  */
-type Section = {
-  uuid: string;
-  variant: "translation" | "phonemic";
+type Text<T extends ReadonlyArray<string>, U extends ItemLocation = "topLevel"> = Prettify<BaseItem<"text", T, U> & {
   type: string;
-  identification: Identification;
-  projectIdentification: Identification | null;
-};
+  text: string | null;
+  language: string | null;
+  image: Image<T> | null;
+  coordinates: Array<Coordinates<T>>;
+  links: ItemLinks<T>;
+  reverseLinks: ItemLinks<T>;
+  notes: Array<Note<T>>;
+  sections: Array<Section<T>>;
+  periods: Array<Period<T, "nested">>;
+  creators: Array<Person<T, "nested">>;
+  editions: Array<Person<T, "nested">>;
+}>;
 /**
- * Represents a tree structure containing resources, spatial units and concepts
+ *  Section in OCHRE
  */
-type Tree<U extends Exclude<DataCategory, "tree"> = Exclude<DataCategory, "tree">> = {
+type Section<T extends ReadonlyArray<string>> = {
   uuid: string;
-  category: "tree";
-  belongsTo: {
-    uuid: string;
-    abbreviation: string;
-  } | null;
-  metadata: Metadata | null;
   publicationDateTime: Date | null;
-  persistentUrl: string | null;
-  type: string;
-  number: number;
-  date: string | null;
-  license: License | null;
-  identification: Identification;
-  creators: Array<Person>;
-  properties: Array<Property>;
-  items: [Exclude<DataCategory, "tree">] extends [U] ? Array<Item> : U extends "resource" ? Array<Resource> : U extends "spatialUnit" ? Array<SpatialUnit> : U extends "concept" ? Array<Concept> : U extends "period" ? Array<Period> : U extends "bibliography" ? Array<Bibliography> : U extends "person" ? Array<Person> : U extends "propertyVariable" ? Array<PropertyVariable> : U extends "propertyValue" ? Array<PropertyValue> : U extends "text" ? Array<Text> : U extends "set" ? Array<Set<U extends Array<DataCategory> ? U : Array<U>>> : Array<Item>;
+  identification: Identification<T>;
+  project: {
+    identification: Identification<T>;
+  } | null;
 };
 /**
  * Represents a gallery with its identification, project identification, resources and max length
  */
-type Gallery = {
-  identification: Identification;
-  projectIdentification: Identification;
-  resources: Array<Resource>;
+type Gallery<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
+  identification: Identification<T>;
+  projectIdentification: Identification<T>;
+  resources: Array<Resource<T, "nested">>;
   maxLength: number;
 };
 /**
@@ -640,7 +806,7 @@ type Gallery = {
  */
 type PropertyValueQueryItem = {
   count: number;
-  dataType: Exclude<PropertyValueContentType, "coordinate">;
+  dataType: Exclude<PropertyValueContent<ReadonlyArray<string>>["dataType"], "coordinate">;
   content: string | number | boolean | null;
   label: string | null;
 };
@@ -667,7 +833,7 @@ type SetItemsSort = {
 } | {
   target: "propertyValue";
   propertyVariableUuid: string;
-  dataType: Exclude<PropertyValueContentType, "coordinate">;
+  dataType: Exclude<PropertyValueContent<ReadonlyArray<string>>["dataType"], "coordinate">;
   direction?: SetItemsSortDirection;
   language?: string;
 };
@@ -677,7 +843,7 @@ type SetItemsSort = {
 type QueryLeaf = {
   target: "property";
   propertyVariable?: string;
-  dataType: Exclude<Exclude<PropertyValueContentType, "coordinate">, "date" | "dateTime">;
+  dataType: Exclude<PropertyValueContent<ReadonlyArray<string>>["dataType"], "coordinate" | "date" | "dateTime">;
   value?: string;
   from?: never;
   to?: never;
@@ -719,43 +885,259 @@ type QueryLeaf = {
   language: string;
   isNegated?: boolean;
 } | {
-  target: "property";
-  propertyVariable?: string;
-  dataType: "all";
-  value: string;
-  matchMode: "includes" | "exact";
-  isCaseSensitive: boolean;
-  language: string;
-  isNegated?: boolean;
+  target: "property";
+  propertyVariable?: string;
+  dataType: "all";
+  value: string;
+  matchMode: "includes" | "exact";
+  isCaseSensitive: boolean;
+  language: string;
+  isNegated?: boolean;
+} | {
+  target: "string";
+  value: string;
+  matchMode: "includes" | "exact";
+  isCaseSensitive: boolean;
+  language: string;
+  isNegated?: boolean;
+} | {
+  target: "title" | "description" | "image" | "periods" | "bibliography" | "notes";
+  value: string;
+  matchMode: "includes" | "exact";
+  isCaseSensitive: boolean;
+  language: string;
+  isNegated?: boolean;
+};
+/**
+ * Represents a boolean query group for Set items
+ */
+type QueryGroup = {
+  and: Array<Query>;
+} | {
+  or: Array<Query>;
+};
+/**
+ * Represents a query for Set items
+ */
+type Query = QueryLeaf | QueryGroup;
+//#endregion
+//#region src/fetchers/gallery.d.ts
+type FetchFunction$4 = (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
+type FetchGalleryBaseOptions<TLanguages extends ReadonlyArray<string> | undefined = undefined> = {
+  languages?: TLanguages;
+  isRichText?: boolean;
+  fetch?: FetchFunction$4;
+};
+type FetchGalleryLanguages<TLanguages extends ReadonlyArray<string> | undefined> = TLanguages extends readonly [] ? ReadonlyArray<string> : TLanguages extends ReadonlyArray<string> ? TLanguages : ReadonlyArray<string>;
+/**
+ * Fetches and parses a gallery from the OCHRE API
+ *
+ * @param params - The parameters for the fetch
+ * @param params.uuid - The UUID of the gallery
+ * @param params.filter - The filter to apply to the gallery
+ * @param params.page - The page number to fetch
+ * @param params.perPage - The number of items per page
+ * @param options - The options for the fetch
+ * @param options.languages - Language codes to parse. Inline arrays preserve literal types automatically.
+ * @param options.isRichText - Whether to parse rich text fields as HTML strings
+ * @param options.fetch - The fetch function to use
+ * @returns The parsed gallery or an error message if the fetch/parse fails
+ */
+declare function fetchGallery<const TLanguages extends ReadonlyArray<string> | undefined = undefined>(params: {
+  uuid: string;
+  filter?: string;
+  page: number;
+  perPage: number;
+}, options?: FetchGalleryBaseOptions<TLanguages>): Promise<{
+  gallery: Gallery<FetchGalleryLanguages<TLanguages>>;
+  error: null;
+} | {
+  gallery: null;
+  error: string;
+}>;
+//#endregion
+//#region src/fetchers/item-links.d.ts
+type FetchFunction$3 = (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
+type FetchItemLinksBaseOptions<TLanguages extends ReadonlyArray<string> | undefined = undefined> = {
+  languages?: TLanguages;
+  isRichText?: boolean;
+  fetch?: FetchFunction$3;
+};
+type FetchItemLinksLanguages<TLanguages extends ReadonlyArray<string> | undefined> = TLanguages extends readonly [] ? ReadonlyArray<string> : TLanguages extends ReadonlyArray<string> ? TLanguages : ReadonlyArray<string>;
+/**
+ * Fetches linked OCHRE items by source-item UUID.
+ *
+ * @param uuid - The UUID of the OCHRE item whose linked items should be fetched
+ * @param options - Fetch and parser options
+ * @param options.itemCategory - The category of items inside linked Trees/Sets to parse. Tree accepts one category; Set accepts one category or an array.
+ * @param options.languages - Language codes to parse. Inline arrays preserve literal types automatically.
+ * @param options.isRichText - Whether to parse the text as rich text
+ * @param options.fetch - Custom fetch function to use instead of the default fetch
+ * @returns An object containing parsed linked items
+ */
+declare function fetchItemLinks<const TItemCategory extends HierarchyItemCategoryOption<HierarchyDataCategory> | undefined = undefined, const TLanguages extends ReadonlyArray<string> | undefined = undefined>(uuid: string, options?: FetchItemLinksBaseOptions<TLanguages> & {
+  itemCategory?: TItemCategory;
+}): Promise<{
+  items: Array<Item<DataCategory, HierarchyItemCategoryFromOption<DataCategory, TItemCategory>, FetchItemLinksLanguages<TLanguages>, "nested">>;
+  error: null;
+} | {
+  items: null;
+  error: string;
+}>;
+//#endregion
+//#region src/fetchers/item.d.ts
+type FetchFunction$2 = (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
+type FetchItemBaseOptions<TLanguages extends ReadonlyArray<string> | undefined = undefined> = {
+  languages?: TLanguages;
+  isRichText?: boolean;
+  fetch?: FetchFunction$2;
+};
+type FetchItemLanguages<TLanguages extends ReadonlyArray<string> | undefined> = TLanguages extends readonly [] ? ReadonlyArray<string> : TLanguages extends ReadonlyArray<string> ? TLanguages : ReadonlyArray<string>;
+/**
+ * Defines a reusable languages tuple with validation and literal type inference.
+ *
+ * Inline arrays can be passed directly to fetchItem:
+ * `fetchItem(uuid, { languages: ["eng", "spa"] })`.
+ *
+ * Use this helper when the language set is stored separately:
+ * `const languages = defineLanguages("eng", "spa")`.
+ */
+declare function defineLanguages<const TLanguages extends ReadonlyArray<string>>(...languages: TLanguages): TLanguages;
+/**
+ * @deprecated Pass inline language arrays directly to fetchItem, or use
+ * defineLanguages("eng", "spa") for reusable language tuples.
+ */
+declare function withLanguages<const TLanguages extends ReadonlyArray<string>>(languages: TLanguages): TLanguages;
+/**
+ * Fetches an OCHRE item by UUID from the OCHRE API
+ *
+ * @param uuid - The UUID of the OCHRE item to fetch
+ * @param options - Required options object
+ * @param options.category - The category of the OCHRE item to fetch
+ * @param options.itemCategory - The category of items inside the OCHRE item to fetch. Only valid for Trees and Sets. Tree accepts one category; Set accepts one category or an array.
+ * @param options.languages - Language codes to parse. Inline arrays preserve literal types automatically.
+ * @param options.isRichText - Whether to parse the text as rich text
+ * @param options.fetch - Custom fetch function to use instead of the default fetch
+ * @returns An object containing the parsed item
+ */
+declare function fetchItem<const TItemCategory extends HierarchyItemCategoryOption<HierarchyDataCategory> | undefined = undefined, const TLanguages extends ReadonlyArray<string> | undefined = undefined>(uuid: string, options?: FetchItemBaseOptions<TLanguages> & {
+  category?: undefined;
+  itemCategory?: TItemCategory;
+}): Promise<{
+  item: Item<DataCategory, HierarchyItemCategoryFromOption<DataCategory, TItemCategory>, FetchItemLanguages<TLanguages>>;
+  error: null;
+} | {
+  item: null;
+  error: string;
+}>;
+declare function fetchItem<const TCategory extends HierarchyDataCategory, const TItemCategory extends HierarchyItemCategoryOption<TCategory> | undefined = undefined, const TLanguages extends ReadonlyArray<string> | undefined = undefined>(uuid: string, options: FetchItemBaseOptions<TLanguages> & {
+  category: TCategory;
+  itemCategory?: TItemCategory;
+}): Promise<{
+  item: Item<TCategory, HierarchyItemCategoryFromOption<TCategory, TItemCategory>, FetchItemLanguages<TLanguages>>;
+  error: null;
 } | {
-  target: "string";
-  value: string;
-  matchMode: "includes" | "exact";
-  isCaseSensitive: boolean;
-  language: string;
-  isNegated?: boolean;
+  item: null;
+  error: string;
+}>;
+declare function fetchItem<const TCategory extends DataCategory, const TLanguages extends ReadonlyArray<string> | undefined = undefined>(uuid: string, options: FetchItemBaseOptions<TLanguages> & {
+  category: TCategory;
+  itemCategory?: never;
+}): Promise<{
+  item: Item<TCategory, HierarchyItemDataCategory<TCategory>, FetchItemLanguages<TLanguages>>;
+  error: null;
 } | {
-  target: "title" | "description" | "image" | "periods" | "bibliography" | "notes";
-  value: string;
-  matchMode: "includes" | "exact";
-  isCaseSensitive: boolean;
-  language: string;
-  isNegated?: boolean;
+  item: null;
+  error: string;
+}>;
+//#endregion
+//#region src/fetchers/set/items.d.ts
+type FetchFunction$1 = (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
+type FetchSetItemsBaseOptions<TLanguages extends ReadonlyArray<string> | undefined = undefined> = {
+  languages?: TLanguages;
+  isRichText?: boolean;
+  fetch?: FetchFunction$1;
 };
+type FetchSetItemsLanguages<TLanguages extends ReadonlyArray<string> | undefined> = TLanguages extends readonly [] ? ReadonlyArray<string> : TLanguages extends ReadonlyArray<string> ? TLanguages : ReadonlyArray<string>;
+type FetchSetItemsCategory<TItemCategories extends ReadonlyArray<SetItemDataCategory> | undefined> = TItemCategories extends ReadonlyArray<infer U> ? Extract<U, SetItemDataCategory> : SetItemDataCategory;
 /**
- * Represents a boolean query group for Set items
+ * Fetches and parses Set items from the OCHRE API
+ *
+ * @param params - The parameters for the fetch
+ * @param params.setScopeUuids - The Set scope UUIDs to filter by
+ * @param params.queries - Recursive query tree used to filter matching items
+ * @param params.sort - Optional sorting configuration applied before pagination.
+ * For propertyValue sorting, dataType is required and the sort key uses the first valid leaf value (value[not(@i)]).
+ * @param params.page - The page number (1-indexed)
+ * @param params.pageSize - The number of items per page
+ * @param itemCategories - The categories of the items to fetch
+ * @param options - Options for the fetch
+ * @param options.fetch - The fetch function to use
+ * @returns The parsed Set items or null if the fetch/parse fails
  */
-type QueryGroup = {
-  and: Array<Query>;
+declare function fetchSetItems<const TItemCategories extends ReadonlyArray<SetItemDataCategory> | undefined = undefined, const TLanguages extends ReadonlyArray<string> | undefined = undefined>(params: {
+  setScopeUuids: Array<string>;
+  queries?: Query | null;
+  sort?: SetItemsSort;
+  page: number;
+  pageSize?: number;
+}, itemCategories?: TItemCategories, options?: FetchSetItemsBaseOptions<TLanguages>): Promise<{
+  totalCount: number;
+  page: number;
+  pageSize: number;
+  items: Array<SetItem<FetchSetItemsCategory<TItemCategories>, FetchSetItemsLanguages<TLanguages>>>;
+  error: null;
 } | {
-  or: Array<Query>;
-};
+  totalCount: null;
+  page: null;
+  pageSize: null;
+  items: null;
+  error: string;
+}>;
+//#endregion
+//#region src/fetchers/set/property-values.d.ts
 /**
- * Represents a query for Set items
+ * Fetches and parses Set property values from the OCHRE API
+ *
+ * @param params - The parameters for the fetch
+ * @param params.setScopeUuids - An array of set scope UUIDs to filter by
+ * @param params.queries - Recursive query tree used to filter matching items
+ * @param params.attributes - Whether to return values for bibliographies and periods
+ * @param params.attributes.bibliographies - Whether to return values for bibliographies
+ * @param params.attributes.periods - Whether to return values for periods
+ * @param params.isLimitedToLeafPropertyValues - Whether to limit the property values to leaf property values
+ * @param options - Options for the fetch
+ * @param options.fetch - The fetch function to use
+ * @returns Parsed Set property values and requested attribute values.
+ * Returns empty arrays/objects when no matches are found, and null outputs on fetch/parse errors.
  */
-type Query = QueryLeaf | QueryGroup;
+declare function fetchSetPropertyValues(params: {
+  setScopeUuids: Array<string>;
+  queries?: Query | null;
+  attributes?: {
+    bibliographies: boolean;
+    periods: boolean;
+  };
+  isLimitedToLeafPropertyValues?: boolean;
+}, options?: {
+  fetch?: (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
+}): Promise<{
+  propertyValues: Array<PropertyValueQueryItem>;
+  propertyValuesByPropertyVariableUuid: Record<string, Array<PropertyValueQueryItem>>;
+  attributeValues: {
+    bibliographies: Array<SetAttributeValueQueryItem> | null;
+    periods: Array<SetAttributeValueQueryItem> | null;
+  };
+  error: null;
+} | {
+  propertyValues: null;
+  propertyValuesByPropertyVariableUuid: null;
+  attributeValues: null;
+  error: string;
+}>;
 //#endregion
 //#region src/types/website.d.ts
+type WebsitePropertyValueDataType = Exclude<PropertyValueContent<ReadonlyArray<string>>["dataType"], "coordinate">;
 /**
  * Represents a context tree level item with a variable and value
  */
@@ -766,17 +1148,17 @@ type ContextTreeLevelItem = {
 /**
  * Represents a context tree level with a context item
  */
-type ContextTreeLevel = {
+type ContextTreeLevel<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   context: Array<ContextTreeLevelItem>;
-  identification: Identification;
+  identification: Identification<T>;
   type: string;
 };
 /**
  * Represents a filter context tree level with a context item
  */
-type ContextTreeFilterLevel = {
+type ContextTreeFilterLevel<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   context: Array<ContextTreeLevelItem>;
-  identification: Identification;
+  identification: Identification<T>;
   type: string;
   filterType: "property" | "coordinates" | "bibliography" | "period";
   isInlineDisplayed: boolean;
@@ -786,23 +1168,23 @@ type ContextTreeFilterLevel = {
 /**
  * Represents a context tree with levels grouped by behavior
  */
-type ContextTree = {
-  flatten: Array<ContextTreeLevel>;
-  suppress: Array<ContextTreeLevel>;
-  filter: Array<ContextTreeFilterLevel>;
-  sort: Array<ContextTreeLevel>;
-  detail: Array<ContextTreeLevel>;
-  download: Array<ContextTreeLevel>;
-  label: Array<ContextTreeLevel>;
-  prominent: Array<ContextTreeLevel>;
+type ContextTree<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
+  flatten: Array<ContextTreeLevel<T>>;
+  suppress: Array<ContextTreeLevel<T>>;
+  filter: Array<ContextTreeFilterLevel<T>>;
+  sort: Array<ContextTreeLevel<T>>;
+  detail: Array<ContextTreeLevel<T>>;
+  download: Array<ContextTreeLevel<T>>;
+  label: Array<ContextTreeLevel<T>>;
+  prominent: Array<ContextTreeLevel<T>>;
 };
 /**
  * Represents a scope with its UUID, type and identification
  */
-type Scope = {
+type Scope<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   uuid: string;
   type: string;
-  identification: Identification;
+  identification: Identification<T>;
 };
 /**
  * Represents a stylesheet item with its UUID and category
@@ -828,18 +1210,18 @@ type StylesheetItem = {
     mobile: Array<Style>;
   };
 };
-type WebsitePropertyQueryNode = {
+type WebsitePropertyQueryNode<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   target: "property";
   propertyVariable: string;
-  dataType: Exclude<PropertyValueContentType, "coordinate">;
+  dataType: WebsitePropertyValueDataType;
   matchMode: "includes" | "exact";
   isCaseSensitive: boolean;
-  language: string;
+  language: T[number];
 };
-type WebsitePropertyQuery = WebsitePropertyQueryNode | {
-  and: Array<WebsitePropertyQuery>;
+type WebsitePropertyQuery<T extends ReadonlyArray<string> = ReadonlyArray<string>> = WebsitePropertyQueryNode<T> | {
+  and: Array<WebsitePropertyQuery<T>>;
 } | {
-  or: Array<WebsitePropertyQuery>;
+  or: Array<WebsitePropertyQuery<T>>;
 };
 /**
  * Represents the OCHRE website type
@@ -848,19 +1230,18 @@ type WebsiteType = "traditional" | "digital-collection" | "plum" | "cedar" | "el
 /**
  * Represents a website with its properties and elements
  */
-type Website = {
+type Website<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   uuid: string;
-  version: ApiVersion;
   belongsTo: {
     uuid: string;
     abbreviation: string;
   } | null;
-  metadata: Metadata;
+  metadata: Metadata<T>;
   publicationDateTime: Date | null;
-  identification: Identification;
-  creators: Array<Person>;
+  identification: Identification<T>;
+  creators: Array<Person<T, "nested">>;
   license: License | null;
-  items: Array<Webpage | WebSegment>;
+  items: Array<Webpage<T> | WebSegment<T>>;
   properties: {
     type: WebsiteType;
     status: "development" | "preview" | "production";
@@ -885,17 +1266,17 @@ type Website = {
       alignment: "start" | "center" | "end";
       isProjectDisplayed: boolean;
       searchBarBoundElementUuid: string | null;
-      items: Array<WebElement | WebBlock> | null;
+      items: Array<WebElement<T> | WebBlock<T>> | null;
     };
     footer: {
       isDisplayed: boolean;
       logoUuid: string | null;
-      items: Array<WebElement | WebBlock> | null;
+      items: Array<WebElement<T> | WebBlock<T>> | null;
     };
     sidebar: {
       isDisplayed: boolean;
-      items: Array<WebElement | WebBlock>;
-      title: WebElement["title"];
+      items: Array<WebElement<T> | WebBlock<T>>;
+      title: WebTitle<T>;
       layout: "start" | "end";
       mobileLayout: "default" | "inline";
       cssStyles: {
@@ -919,10 +1300,10 @@ type Website = {
       iiifViewer: "universal-viewer" | "clover";
     };
     options: {
-      contextTree: ContextTree | null;
-      scopes: Array<Scope> | null;
+      contextTree: ContextTree<T> | null;
+      scopes: Array<Scope<T>> | null;
       labels: {
-        title: string | null;
+        title: MultilingualString<T> | null;
       };
       stylesheets: {
         properties: Array<StylesheetItem>;
@@ -933,13 +1314,13 @@ type Website = {
 /**
  * Represents a webpage with its title, slug, properties, items and subpages
  */
-type Webpage = {
+type Webpage<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   uuid: string;
   type: "page";
-  title: string;
+  title: MultilingualString<T>;
   slug: string;
   publicationDateTime: Date | null;
-  items: Array<WebSegment | WebElement | WebBlock>;
+  items: Array<WebSegment<T> | WebElement<T> | WebBlock<T>>;
   properties: {
     width: "full" | "large" | "narrow" | "default";
     variant: "default" | "no-background";
@@ -947,42 +1328,42 @@ type Webpage = {
     isSidebarDisplayed: boolean;
     isDisplayedInNavbar: boolean;
     isNavbarSearchBarDisplayed: boolean;
-    backgroundImage: WebImage | null;
+    backgroundImage: WebImage<T> | null;
     cssStyles: {
       default: Array<Style>;
       tablet: Array<Style>;
       mobile: Array<Style>;
     };
   };
-  webpages: Array<Webpage>;
+  webpages: Array<Webpage<T>>;
 };
 /**
  * Represents a web segment
  */
-type WebSegment = {
+type WebSegment<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   uuid: string;
   type: "segment";
-  title: string;
+  title: MultilingualString<T>;
   slug: string;
   publicationDateTime: Date | null;
-  items: Array<WebSegmentItem>;
+  items: Array<WebSegmentItem<T>>;
 };
 /**
  * Represents a web segment item
  */
-type WebSegmentItem = {
+type WebSegmentItem<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   uuid: string;
   type: "segment-item";
-  title: string;
+  title: MultilingualString<T>;
   slug: string;
   publicationDateTime: Date | null;
-  items: Array<Webpage | WebSegment>;
+  items: Array<Webpage<T> | WebSegment<T>>;
 };
 /**
  * Represents a title with its label and variant
  */
-type WebTitle = {
-  label: string;
+type WebTitle<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
+  label: MultilingualString<T>;
   variant: "default" | "simple";
   properties: {
     isNameDisplayed: boolean;
@@ -995,20 +1376,20 @@ type WebTitle = {
 /**
  * Base properties for web elements
  */
-type WebElement = {
+type WebElement<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   uuid: string;
   type: "element";
-  title: WebTitle;
+  title: WebTitle<T>;
   cssStyles: {
     default: Array<Style>;
     tablet: Array<Style>;
     mobile: Array<Style>;
   };
-} & WebElementComponent;
+} & WebElementComponent<T>;
 /**
  * Union type of all possible web element components
  */
-type WebElementComponent = {
+type WebElementComponent<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   component: "3d-viewer";
   linkUuid: string;
   fileSize: number | null;
@@ -1037,7 +1418,7 @@ type WebElementComponent = {
 } | {
   component: "bibliography";
   linkUuids: Array<string>;
-  bibliographies: Array<Bibliography>;
+  bibliographies: Array<Bibliography<T, "nested">>;
   layout: "long" | "short";
   isSourceDocumentDisplayed: boolean;
 } | {
@@ -1050,16 +1431,16 @@ type WebElementComponent = {
   variant: "default" | "transparent" | "link";
   href: string;
   isExternal: boolean;
-  label: string | null;
+  label: MultilingualString<T> | null;
   startIcon: string | null;
   endIcon: string | null;
-  image: WebImage | null;
+  image: WebImage<T> | null;
 } | {
   component: "collection";
   linkUuids: Array<string>;
   displayedProperties: Array<{
     uuid: string;
-    label: string;
+    label: MultilingualString<T> | null;
   }> | null;
   variant: "slide" | "table" | "card" | "tile" | "showcase";
   paginationVariant: "default" | "numeric";
@@ -1076,10 +1457,10 @@ type WebElementComponent = {
     sidebarSort: "default" | "alphabetical";
   };
   options: {
-    scopes: Array<Scope> | null;
-    contextTree: ContextTree | null;
+    scopes: Array<Scope<T>> | null;
+    contextTree: ContextTree<T> | null;
     labels: {
-      title: string | null;
+      title: MultilingualString<T> | null;
     };
   };
 } | {
@@ -1097,7 +1478,7 @@ type WebElementComponent = {
   variant: "universal-viewer" | "clover";
 } | {
   component: "image";
-  images: Array<WebImage>;
+  images: Array<WebImage<T>>;
   variant: "default" | "carousel" | "grid" | "hero";
   width: number | null;
   height: number | null;
@@ -1136,31 +1517,31 @@ type WebElementComponent = {
   linkUuids: Array<string>;
   items: Array<{
     label: string;
-    queries: Array<WebsitePropertyQuery>;
+    queries: Array<WebsitePropertyQuery<T>>;
     startIcon: string | null;
     endIcon: string | null;
   }>;
   options: {
-    scopes: Array<Scope> | null;
-    contextTree: ContextTree | null;
+    scopes: Array<Scope<T>> | null;
+    contextTree: ContextTree<T> | null;
     labels: {
-      title: string | null;
+      title: MultilingualString<T> | null;
     };
   };
   collectionProperties: {
-    displayedProperties: Extract<WebElementComponent, {
+    displayedProperties: Extract<WebElementComponent<T>, {
       component: "collection";
     }>["displayedProperties"];
-    variant: Extract<WebElementComponent, {
+    variant: Extract<WebElementComponent<T>, {
       component: "collection";
     }>["variant"];
-    paginationVariant: Extract<WebElementComponent, {
+    paginationVariant: Extract<WebElementComponent<T>, {
       component: "collection";
     }>["paginationVariant"];
-    loadingVariant: Extract<WebElementComponent, {
+    loadingVariant: Extract<WebElementComponent<T>, {
       component: "collection";
     }>["loadingVariant"];
-    imageLayout: Extract<WebElementComponent, {
+    imageLayout: Extract<WebElementComponent<T>, {
       component: "collection";
     }>["imageLayout"];
   };
@@ -1192,7 +1573,7 @@ type WebElementComponent = {
     size: "xs" | "sm" | "md" | "lg";
   };
   headingLevel: "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | null;
-  content: string;
+  content: MultilingualString<T>;
 } | {
   component: "timeline";
   linkUuid: string;
@@ -1204,10 +1585,10 @@ type WebElementComponent = {
 /**
  * Represents an image used in web elements
  */
-type WebImage = {
+type WebImage<T extends ReadonlyArray<string> = ReadonlyArray<string>> = {
   uuid: string | null;
-  label: string | null;
-  description: string | null;
+  label: MultilingualString<T> | null;
+  description: MultilingualString<T> | null;
   width: number;
   height: number;
   quality: "low" | "high";
@@ -1223,18 +1604,18 @@ type WebBlockLayout = "vertical" | "horizontal" | "grid" | "vertical-flex" | "ho
 /**
  * Represents a block of vertical or horizontal content alignment
  */
-type WebBlock<T extends WebBlockLayout = WebBlockLayout> = {
+type WebBlock<T extends ReadonlyArray<string> = ReadonlyArray<string>, U extends WebBlockLayout = WebBlockLayout> = {
   uuid: string;
   type: "block";
-  title: WebTitle;
-  items: T extends "accordion" ? Array<Extract<WebElement, {
+  title: WebTitle<T>;
+  items: U extends "accordion" ? Array<Extract<WebElement<T>, {
     component: "text";
   }> & {
-    items: Array<WebElement | WebBlock>;
-  }> : Array<WebElement | WebBlock>;
+    items: Array<WebElement<T> | WebBlock<T>>;
+  }> : Array<WebElement<T> | WebBlock<T>>;
   properties: {
     default: {
-      layout: T;
+      layout: U;
       wrap: "nowrap" | "wrap" | "wrap-reverse";
       /**
        * valid `gridTemplateColumns` or `gridTemplateRows` CSS property value
@@ -1244,12 +1625,12 @@ type WebBlock<T extends WebBlockLayout = WebBlockLayout> = {
        * `gap` CSS property value
        */
       gap: string | null;
-      isAccordionEnabled: T extends "accordion" ? boolean : never;
-      isAccordionExpandedByDefault: T extends "accordion" ? boolean : never;
-      isAccordionSidebarDisplayed: T extends "accordion" ? boolean : never;
+      isAccordionEnabled: U extends "accordion" ? boolean : never;
+      isAccordionExpandedByDefault: U extends "accordion" ? boolean : never;
+      isAccordionSidebarDisplayed: U extends "accordion" ? boolean : never;
     };
-    tablet: Partial<WebBlock["properties"]["default"]> | null;
-    mobile: Partial<WebBlock["properties"]["default"]> | null;
+    tablet: Partial<WebBlock<T>["properties"]["default"]> | null;
+    mobile: Partial<WebBlock<T>["properties"]["default"]> | null;
   };
   cssStyles: {
     default: Array<Style>;
@@ -1258,361 +1639,198 @@ type WebBlock<T extends WebBlockLayout = WebBlockLayout> = {
   };
 };
 //#endregion
-//#region src/utils/fetchers/gallery.d.ts
-/**
- * Fetches and parses a gallery from the OCHRE API
- *
- * @param params - The parameters for the fetch
- * @param params.uuid - The UUID of the gallery
- * @param params.filter - The filter to apply to the gallery
- * @param params.page - The page number to fetch
- * @param params.pageSize - The number of items per page
- * @param options - The options for the fetch
- * @param options.fetch - The fetch function to use
- * @param options.version - The version of the OCHRE API to use
- * @returns The parsed gallery or an error message if the fetch/parse fails
- */
-declare function fetchGallery(params: {
-  uuid: string;
-  filter?: string;
-  page: number;
-  pageSize: number;
-}, options?: {
-  fetch?: (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
-  version?: ApiVersion;
-}): Promise<{
-  gallery: Gallery | null;
-  error: null;
-} | {
-  gallery: null;
-  error: string;
-}>;
-//#endregion
-//#region src/utils/fetchers/item-links.d.ts
-/**
- * Fetches and parses an OCHRE item links from the OCHRE API
- *
- * @param uuid - The UUID of the OCHRE item to fetch
- * @param category - The category of the OCHRE item to fetch
- * @param itemCategories - The categories of the OCHRE linked items to fetch
- * @param options - The options for the fetch
- * @param options.fetch - The fetch function to use
- * @param options.version - The version of the OCHRE API to use
- * @returns Object containing the parsed OCHRE item links, or an error message if the fetch/parse fails
- */
-declare function fetchItemLinks<T extends DataCategory = DataCategory, U extends DataCategory | Array<DataCategory> = (T extends "tree" ? Exclude<DataCategory, "tree"> : T extends "set" ? Array<DataCategory> : never)>(uuid: string, category?: T, itemCategories?: U, options?: {
-  fetch?: (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
-  version?: ApiVersion;
-}): Promise<{
-  error: null;
-  items: Array<Item<T, U>>;
-} | {
-  error: string;
-  items: never;
-}>;
-//#endregion
-//#region src/utils/fetchers/item.d.ts
-/**
- * Fetches and parses an OCHRE item from the OCHRE API
- *
- * @param uuid - The UUID of the OCHRE item to fetch
- * @param category - The category of the OCHRE item to fetch
- * @param itemCategories - The categories of the OCHRE items to fetch
- * @param options - The options for the fetch
- * @param options.fetch - The fetch function to use
- * @param options.version - The version of the OCHRE API to use
- * @returns Object containing the parsed OCHRE item, or an error message if the fetch/parse fails
- */
-declare function fetchItem<T extends DataCategory = DataCategory, U extends DataCategory | Array<DataCategory> = (T extends "tree" ? Exclude<DataCategory, "tree"> : T extends "set" ? Array<DataCategory> : never)>(uuid: string, category?: T, itemCategories?: U, options?: {
-  fetch?: (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
-  version?: ApiVersion;
-}): Promise<{
-  error: null;
-  item: Item<T, U>;
-} | {
-  error: string;
-  item: never;
-}>;
-//#endregion
-//#region src/utils/fetchers/set/items.d.ts
-/**
- * Fetches and parses Set items from the OCHRE API
- *
- * @param params - The parameters for the fetch
- * @param params.setScopeUuids - The Set scope UUIDs to filter by
- * @param params.queries - Recursive query tree used to filter matching items
- * @param params.sort - Optional sorting configuration applied before pagination.
- * For propertyValue sorting, dataType is required and the sort key uses the first valid leaf value (value[not(@i)]).
- * @param params.page - The page number (1-indexed)
- * @param params.pageSize - The number of items per page
- * @param itemCategories - The categories of the items to fetch
- * @param options - Options for the fetch
- * @param options.fetch - The fetch function to use
- * @param options.version - The version of the OCHRE API to use
- * @returns The parsed Set items or null if the fetch/parse fails
- */
-declare function fetchSetItems<U extends Array<DataCategory> = Array<DataCategory>>(params: {
-  setScopeUuids: Array<string>;
-  queries?: Query | null;
-  sort?: SetItemsSort;
-  page: number;
-  pageSize?: number;
-}, itemCategories?: U, options?: {
-  fetch?: (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
-  version?: ApiVersion;
-}): Promise<{
-  totalCount: number;
-  page: number;
-  pageSize: number;
-  items: Array<Item<"set", U>>;
-  error: null;
-} | {
-  totalCount: null;
-  page: null;
-  pageSize: null;
-  items: null;
-  error: string;
-}>;
-//#endregion
-//#region src/utils/fetchers/set/property-values.d.ts
-/**
- * Fetches and parses Set property values from the OCHRE API
- *
- * @param params - The parameters for the fetch
- * @param params.setScopeUuids - An array of set scope UUIDs to filter by
- * @param params.queries - Recursive query tree used to filter matching items
- * @param params.attributes - Whether to return values for bibliographies and periods
- * @param params.attributes.bibliographies - Whether to return values for bibliographies
- * @param params.attributes.periods - Whether to return values for periods
- * @param params.isLimitedToLeafPropertyValues - Whether to limit the property values to leaf property values
- * @param options - Options for the fetch
- * @param options.fetch - The fetch function to use
- * @param options.version - The version of the OCHRE API to use
- * @returns Parsed Set property values and requested attribute values.
- * Returns empty arrays/objects when no matches are found, and null outputs on fetch/parse errors.
- */
-declare function fetchSetPropertyValues(params: {
-  setScopeUuids: Array<string>;
-  queries?: Query | null;
-  attributes?: {
-    bibliographies: boolean;
-    periods: boolean;
-  };
-  isLimitedToLeafPropertyValues?: boolean;
-}, options?: {
-  fetch?: (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
-  version?: ApiVersion;
-}): Promise<{
-  propertyValues: Array<PropertyValueQueryItem>;
-  propertyValuesByPropertyVariableUuid: Record<string, Array<PropertyValueQueryItem>>;
-  attributeValues: {
-    bibliographies: Array<SetAttributeValueQueryItem> | null;
-    periods: Array<SetAttributeValueQueryItem> | null;
-  };
-  error: null;
-} | {
-  propertyValues: null;
-  propertyValuesByPropertyVariableUuid: null;
-  attributeValues: null;
-  error: string;
-}>;
-//#endregion
-//#region src/utils/fetchers/website.d.ts
+//#region src/fetchers/website.d.ts
+type FetchFunction = (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
 /**
  * Fetches and parses a website configuration from the OCHRE API
  *
  * @param abbreviation - The abbreviation identifier for the website
  * @returns The parsed website configuration or null if the fetch/parse fails
  */
-declare function fetchWebsite(abbreviation: string, options?: {
-  fetch?: (input: string | URL | globalThis.Request, init?: RequestInit) => Promise<Response>;
-  version?: ApiVersion;
+declare function fetchWebsite<const T extends ReadonlyArray<string> = ReadonlyArray<string>>(abbreviation: string, options?: {
+  fetch?: FetchFunction;
+  languages?: T;
+  isRichText?: boolean;
 }): Promise<{
+  website: Website<T>;
   error: null;
-  website: Website;
 } | {
-  error: string;
   website: null;
+  error: string;
 }>;
 //#endregion
-//#region src/utils/getters.d.ts
+//#region src/getters.d.ts
 /**
- * Options for property search operations
+ * Options for property search operations.
  */
 type PropertyOptions = {
-  /** Whether to recursively search through nested properties */includeNestedProperties?: boolean; /** Whether to limit the search to leaf properties */
+  /** Whether to recursively search through nested properties. */includeNestedProperties?: boolean; /** Whether to limit property values to leaf values. */
   limitToLeafPropertyValues?: boolean;
 };
+type PropertyContent<T extends ReadonlyArray<string>> = PropertyValueContent<T>["content"];
 /**
- * Finds a property by its UUID in an array of properties
+ * Finds a property by its label UUID in an array of properties.
  *
  * @param properties - Array of properties to search through
- * @param uuid - The UUID to search for
+ * @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
  */
-declare function getPropertyByUuid<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, uuid: string, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelUuid: string, options?: PropertyOptions): Property<T> | null;
 /**
- * Retrieves all values for a property with the given UUID
+ * Retrieves all values for a property with the given label UUID.
  *
  * @param properties - Array of properties to search through
- * @param uuid - The UUID to search for
+ * @param labelUuid - The property label UUID to search for
  * @param options - Search options, including whether to include nested properties
- * @returns Array of property values as strings, or null if property not found
+ * @returns Array of property values, or null if property not found
  */
-declare function getPropertyValuesByUuid<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, uuid: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
+declare function getPropertyValuesByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelUuid: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
 /**
- * Retrieves all value contents for a property with the given UUID
+ * Retrieves all value contents for a property with the given label UUID.
  *
  * @param properties - Array of properties to search through
- * @param uuid - The UUID to search for
+ * @param labelUuid - The property label UUID to search for
  * @param options - Search options, including whether to include nested properties
- * @returns Array of property value contents as strings, or null if property not found
+ * @returns Array of property value contents, or null if property not found
  */
-declare function getPropertyValueContentsByUuid<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, uuid: string, options?: PropertyOptions): Array<PropertyValueContent<T>["content"]> | null;
+declare function getPropertyValueContentsByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelUuid: string, options?: PropertyOptions): Array<PropertyContent<T>> | null;
 /**
- * Gets the first value of a property with the given UUID
+ * Gets the first value of a property with the given label UUID.
  *
  * @param properties - Array of properties to search through
- * @param uuid - The UUID to search for
+ * @param labelUuid - The property label UUID to search for
  * @param options - Search options, including whether to include nested properties
- * @returns The first property value as string, or null if property not found
+ * @returns The first property value, or null if property not found
  */
-declare function getPropertyValueByUuid<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, uuid: string, options?: PropertyOptions): PropertyValueContent<T> | null;
+declare function getPropertyValueByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelUuid: string, options?: PropertyOptions): PropertyValueContent<T> | null;
 /**
- * Gets the first value content of a property with the given UUID
+ * Gets the first value content of a property with the given label UUID.
  *
  * @param properties - Array of properties to search through
- * @param uuid - The UUID to search for
+ * @param labelUuid - The property label UUID to search for
  * @param options - Search options, including whether to include nested properties
- * @returns The first property value content as string, or null if property not found
+ * @returns The first property value content, or null if property not found
  */
-declare function getPropertyValueContentByUuid<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, uuid: string, options?: PropertyOptions): PropertyValueContent<T>["content"] | null;
+declare function getPropertyValueContentByLabelUuid<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelUuid: string, options?: PropertyOptions): PropertyContent<T> | null;
 /**
- * Finds a property by its label in an array of properties
+ * Finds a property by its label name in an array of properties.
  *
  * @param properties - Array of properties to search through
- * @param label - The label to search for
+ * @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
  */
-declare function getPropertyByLabel<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, label: string, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, options?: PropertyOptions): Property<T> | null;
 /**
- * Finds a property by its label and all values in an array of properties
+ * Finds a property by its label name and all values.
  *
  * @param properties - Array of properties to search through
- * @param label - The label to search for
- * @param values - The values to search for
+ * @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
  */
-declare function getPropertyByLabelAndValues<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, label: string, values: Array<PropertyValueContent<T>>, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelNameAndValues<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, values: ReadonlyArray<PropertyValueContent<T>>, options?: PropertyOptions): Property<T> | null;
 /**
- * Finds a property by its label and all values in an array of properties
+ * Finds a property by its label name and all value contents.
  *
  * @param properties - Array of properties to search through
- * @param label - The label to search for
+ * @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 values do not match
+ * @returns The matching Property object, or null if not found or all value contents do not match
  */
-declare function getPropertyByLabelAndValueContents<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, label: string, valueContents: Array<PropertyValueContent<T>["content"]>, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelNameAndValueContents<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, valueContents: ReadonlyArray<PropertyContent<T>>, options?: PropertyOptions): Property<T> | null;
 /**
- * Finds a property by its label and value in an array of properties
+ * Finds a property by its label name and one value.
  *
  * @param properties - Array of properties to search through
- * @param label - The label to search for
- * @param value - The value to search for
+ * @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
  */
-declare function getPropertyByLabelAndValue<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, label: string, value: PropertyValueContent<T>, options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelNameAndValue<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, value: PropertyValueContent<T>, options?: PropertyOptions): Property<T> | null;
 /**
- * Finds a property by its label and value content in an array of properties
+ * Finds a property by its label name and one value content.
  *
  * @param properties - Array of properties to search through
- * @param label - The label to search for
+ * @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
  */
-declare function getPropertyByLabelAndValueContent<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, label: string, valueContent: PropertyValueContent<T>["content"], options?: PropertyOptions): Property<T> | null;
+declare function getPropertyByLabelNameAndValueContent<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, valueContent: PropertyContent<T>, options?: PropertyOptions): Property<T> | null;
 /**
- * Retrieves all values for a property with the given label
+ * Retrieves all values for a property with the given label name.
  *
  * @param properties - Array of properties to search through
- * @param label - The label to search for
+ * @param labelName - The property label name to search for
  * @param options - Search options, including whether to include nested properties
- * @returns Array of property values as strings, or null if property not found
+ * @returns Array of property values, or null if property not found
  */
-declare function getPropertyValuesByLabel<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, label: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
+declare function getPropertyValuesByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, options?: PropertyOptions): Array<PropertyValueContent<T>> | null;
 /**
- * Gets the first value of a property with the given label
+ * Gets the first value of a property with the given label name.
  *
  * @param properties - Array of properties to search through
- * @param label - The label to search for
+ * @param labelName - The property label name to search for
  * @param options - Search options, including whether to include nested properties
- * @returns The first property value as string, or null if property not found
+ * @returns The first property value, or null if property not found
  */
-declare function getPropertyValueByLabel<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, label: string, options?: PropertyOptions): PropertyValueContent<T> | null;
+declare function getPropertyValueByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, options?: PropertyOptions): PropertyValueContent<T> | null;
 /**
- * Gets the first value content of a property with the given label
+ * Gets the first value content of a property with the given label name.
  *
  * @param properties - Array of properties to search through
- * @param label - The label to search for
+ * @param labelName - The property label name to search for
  * @param options - Search options, including whether to include nested properties
- * @returns The first property value content as string, or null if property not found
+ * @returns The first property value content, or null if property not found
  */
-declare function getPropertyValueContentByLabel<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, label: string, options?: PropertyOptions): PropertyValueContent<T>["content"] | null;
+declare function getPropertyValueContentByLabelName<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, labelName: string, options?: PropertyOptions): PropertyContent<T> | null;
 /**
- * Gets all unique properties from an array of properties
+ * 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
  */
-declare function getUniqueProperties<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, options?: PropertyOptions): Array<Property<T>>;
+declare function getUniqueProperties<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, options?: PropertyOptions): Array<Property<T>>;
 /**
- * Gets all unique property labels from an array of properties
+ * Gets all unique property label names from an array of properties.
  *
  * @param properties - Array of properties to get unique property labels from
  * @param options - Search options, including whether to include nested properties
- * @returns Array of unique property labels
+ * @returns Array of unique property label names
  */
-declare function getUniquePropertyLabels<T extends PropertyValueContentType = PropertyValueContentType>(properties: Array<Property<T>>, options?: PropertyOptions): Array<string>;
+declare function getUniquePropertyLabelNames<T extends ReadonlyArray<string> = ReadonlyArray<string>>(properties: ReadonlyArray<Property<T>>, options?: PropertyOptions): Array<string>;
 /**
- * Get the leaf property values from an array of property values
+ * Get the leaf property values from an array of property values.
+ *
  * @param propertyValues - The array of property values to get the leaf property values from
  * @returns The array of leaf property values
  */
-declare function getLeafPropertyValues<T extends PropertyValueContentType = PropertyValueContentType>(propertyValues: Array<PropertyValueContent<T>>): Array<PropertyValueContent<T>>;
+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 criteria
+ * Filters a property based on a label and value criterion.
  *
  * @param property - The property to filter
  * @param filter - Filter criteria containing label and value to match
- * @param filter.label - The label to filter by
+ * @param filter.labelName - The 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 PropertyValueContentType = PropertyValueContentType>(property: Property<T>, filter: {
-  label: string;
+declare function filterProperties<T extends ReadonlyArray<string> = ReadonlyArray<string>>(property: Property<T>, filter: {
+  labelName: string;
   value: PropertyValueContent<T>;
 }, options?: PropertyOptions): boolean;
 //#endregion
-//#region src/utils/helpers.d.ts
-/**
- * The default API version to use
- *
- * @remarks
- * Version 1 of the OCHRE API is deprecated and will be removed in the future.
- * It points to the old Tamino server.
- *
- * Version 2 of the OCHRE API is the current version and is the default.
- * It points to the new MarkLogic server.
- */
-declare const DEFAULT_API_VERSION = 2;
+//#region src/helpers.d.ts
+type FlattenedItem<U, T extends ReadonlyArray<string>> = Omit<U, "properties"> & {
+  properties: Array<SingleHierarchyProperty<T>>;
+};
 /**
  * The default page size to use for fetching paginated items
  */
@@ -1622,6 +1840,6 @@ declare const DEFAULT_PAGE_SIZE = 48;
  * @param item - The item whose properties to flatten
  * @returns The item with the properties flattened
  */
-declare function flattenItemProperties<T extends DataCategory = DataCategory, U extends DataCategory | Array<DataCategory> = (T extends "tree" ? Exclude<DataCategory, "tree"> : T extends "set" ? Array<DataCategory> : never)>(item: Item<T, U>): Item<T, U>;
+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 { ApiVersion, Bibliography, Concept, Context, ContextItem, ContextNode, ContextTree, ContextTreeFilterLevel, ContextTreeLevel, ContextTreeLevelItem, Coordinate, DEFAULT_API_VERSION, DEFAULT_PAGE_SIZE, Data, DataCategory, Event, FileFormat, Gallery, Identification, Image, ImageMap, ImageMapArea, Interpretation, Item, License, Link, Metadata, Note, Observation, Period, Person, Property, PropertyValue, PropertyValueContent, PropertyValueContentType, PropertyValueQueryItem, PropertyVariable, Query, QueryGroup, QueryLeaf, Resource, Scope, Section, Set, SetAttributeValueQueryItem, SetItemsSort, SetItemsSortDirection, SpatialUnit, Style, StylesheetCategory, StylesheetItem, Text, Tree, WebBlock, WebBlockLayout, WebElement, WebElementComponent, WebImage, WebSegment, WebSegmentItem, WebTitle, Webpage, Website, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteType, fetchGallery, fetchItem, fetchItemLinks, fetchSetItems, fetchSetPropertyValues, fetchWebsite, filterProperties, flattenItemProperties, getLeafPropertyValues, getPropertyByLabel, getPropertyByLabelAndValue, getPropertyByLabelAndValueContent, getPropertyByLabelAndValueContents, getPropertyByLabelAndValues, getPropertyByUuid, getPropertyValueByLabel, getPropertyValueByUuid, getPropertyValueContentByLabel, getPropertyValueContentByUuid, getPropertyValueContentsByUuid, getPropertyValuesByLabel, getPropertyValuesByUuid, getUniqueProperties, getUniquePropertyLabels };
+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, 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 };