@digitalculture/ochre-sdk 0.7.10 → 0.7.12

package/dist/index.d.ts

@@ -1,656 +1,660 @@
-import { Language } from 'iso-639-3';
+import { Language } from "iso-639-3";
 
+//#region src/types/main.d.ts
+/**
+* Represents the core data structure containing item information and metadata
+*/
 /**
  * Represents the core data structure containing item information and metadata
  */
 type Data<T extends DataCategory> = {
+  uuid: string;
+  belongsTo: {
     uuid: string;
-    belongsTo: {
-        uuid: string;
-        abbreviation: string;
-    };
-    publicationDateTime: Date;
-    metadata: Metadata;
-    item: Tree | Set<T> | Resource | SpatialUnit | Concept | Period | Bibliography | Person | PropertyValue;
+    abbreviation: string;
+  };
+  publicationDateTime: Date;
+  metadata: Metadata;
+  item: Tree | Set<T> | Resource | SpatialUnit | Concept | Period | Bibliography | Person | PropertyValue;
 };
 type DataCategory = "tree" | "set" | "resource" | "spatialUnit" | "concept" | "period" | "bibliography" | "person" | "propertyValue";
 /**
  * Basic identification information used across multiple types
  */
 type Identification = {
-    label: string;
-    abbreviation: string;
+  label: string;
+  abbreviation: string;
 };
 /**
  * Metadata information for items including project, publisher and language details
  */
 type Metadata = {
-    project: {
-        identification: Identification & {
-            website: string | null;
-        };
-    } | null;
-    item: {
-        identification: Identification;
-        category: string;
-        type: string;
-        maxLength: number | null;
-    } | null;
-    dataset: string;
-    publisher: string;
-    languages: Array<Language["iso6393"]>;
-    identifier: string;
-    description: string;
+  project: {
+    identification: Identification & {
+      website: string | null;
+    };
+  } | null;
+  item: {
+    identification: Identification;
+    category: string;
+    type: string;
+    maxLength: number | null;
+  } | null;
+  dataset: string;
+  publisher: string;
+  languages: Array<Language["iso6393"]>;
+  identifier: string;
+  description: string;
 };
 /**
  * Represents a single item in a context hierarchy with its metadata
  */
 type ContextItem = {
-    uuid: string;
-    publicationDateTime: Date | null;
-    number: number;
-    content: string;
+  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>;
+  tree: ContextItem;
+  project: ContextItem;
+  spatialUnit: Array<ContextItem>;
 };
 /**
  * Contains the full context information including nodes and display path
  */
 type Context = {
-    nodes: Array<ContextNode>;
-    displayPath: string;
+  nodes: Array<ContextNode>;
+  displayPath: string;
 };
 /**
  * License information for content items
  */
 type License = {
-    content: string;
-    url: string;
+  content: string;
+  url: string;
 };
 /**
  * Represents a person (author, creator, etc.) with their identification and metadata
  */
 type Person = {
-    uuid: string;
-    category: "person";
-    publicationDateTime: Date | null;
-    type: string | null;
-    number: number | null;
-    context: Context | null;
-    availability: License | null;
-    date: Date | null;
-    identification: Identification | null;
-    address: {
-        country: string | null;
-        city: string | null;
-        state: string | null;
-    } | null;
-    coordinates: Coordinates | null;
-    content: string | null;
-    events: Array<Event>;
-    properties: Array<Property>;
+  uuid: string;
+  category: "person";
+  publicationDateTime: Date | null;
+  type: string | null;
+  number: number | null;
+  context: Context | null;
+  availability: License | null;
+  date: Date | null;
+  identification: Identification | null;
+  address: {
+    country: string | null;
+    city: string | null;
+    state: string | null;
+  } | null;
+  coordinates: Coordinates | null;
+  content: string | null;
+  events: Array<Event>;
+  properties: Array<Property>;
 };
 /**
  * Represents a note with number, title and content
  */
 type Note = {
-    number: number;
-    title: string | null;
-    content: string;
+  number: number;
+  title: string | null;
+  content: string;
 };
 /**
  * Represents an image with its metadata and content
  */
 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;
+  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;
 };
 /**
  * Represents a link to another item with optional image and bibliographic references
  */
 type Link = {
-    uuid: string;
-    publicationDateTime: Date | null;
-    type: string | null;
-    category: string | null;
-    identification: Identification | null;
-    content: string | null;
-    href: string | null;
-    image: {
-        isInline: boolean;
-        isPrimary: boolean;
-        heightPreview: number;
-        widthPreview: number;
-        height: number;
-        width: number;
-    } | null;
-    bibliographies: Array<Bibliography> | null;
+  uuid: string;
+  publicationDateTime: Date | null;
+  type: string | null;
+  category: string | null;
+  identification: Identification | null;
+  content: string | null;
+  href: string | null;
+  image: {
+    isInline: boolean;
+    isPrimary: boolean;
+    heightPreview: number;
+    widthPreview: number;
+    height: number;
+    width: number;
+  } | null;
+  bibliographies: Array<Bibliography> | null;
 };
 /**
  * Represents a clickable/interactive area on an image map
  */
 type ImageMapArea = {
-    uuid: string;
-    publicationDateTime: Date | null;
-    type: string;
-    title: string;
-    shape: "rectangle" | "polygon";
-    coords: Array<number>;
+  uuid: string;
+  publicationDateTime: Date | null;
+  type: string;
+  title: string;
+  shape: "rectangle" | "polygon";
+  coords: Array<number>;
 };
 /**
  * Contains image map areas and dimensions
  */
 type ImageMap = {
-    area: Array<ImageMapArea>;
-    width: number;
-    height: number;
+  area: Array<ImageMapArea>;
+  width: number;
+  height: number;
 };
 /**
  * Geographic coordinates with optional type and label
  */
 type Coordinates = {
-    latitude: number;
-    longitude: number;
-    type: string | null;
-    label: string | null;
+  latitude: number;
+  longitude: number;
+  type: string | null;
+  label: string | null;
 };
 /**
  * Represents an observation with notes, links and properties
  */
 type Observation = {
-    number: number;
-    date: Date | null;
-    observers: Array<string>;
-    notes: Array<Note>;
-    links: Array<Link>;
-    properties: Array<Property>;
+  number: number;
+  date: Date | null;
+  observers: Array<string>;
+  notes: Array<Note>;
+  links: Array<Link>;
+  properties: Array<Property>;
 };
 /**
  * Represents an event with date, label and optional agent
  */
 type Event = {
-    date: Date | null;
-    label: string;
-    agent: {
-        uuid: string;
-        content: string;
-    } | null;
+  date: Date | null;
+  label: string;
+  agent: {
+    uuid: string;
+    content: string;
+  } | null;
 };
 /**
  * Represents an interpretation with date and properties
  */
 type Interpretation = {
-    date: Date | null;
-    number: number;
-    properties: Array<Property>;
+  date: Date | null;
+  number: number;
+  properties: Array<Property>;
 };
 /**
  * Represents a document with content and footnotes
  */
 type Document = {
-    content: string;
-    footnotes: Array<Footnote>;
+  content: string;
+  footnotes: Array<Footnote>;
 };
 /**
  * Represents a footnote in a document
  */
 type Footnote = {
-    uuid: string;
-    label: string;
-    content: string;
+  uuid: string;
+  label: string;
+  content: string;
 };
 /**
  * Represents a resource item with associated metadata, content and relationships
  */
 type Resource = {
-    uuid: string;
-    category: "resource";
-    publicationDateTime: Date | null;
-    type: string;
-    number: number;
-    context: Context | null;
-    license: License | null;
-    copyright: string | null;
-    identification: Identification;
-    date: Date | null;
-    image: Image | null;
-    creators: Array<Person>;
-    notes: Array<Note>;
-    description: string;
-    document: Document | null;
-    href: string | null;
-    imageMap: ImageMap | null;
-    periods: Array<Period>;
-    format: string | null;
-    links: Array<Link>;
-    reverseLinks: Array<Link>;
-    properties: Array<Property>;
-    citedBibliographies: Array<Bibliography>;
-    resources: Array<Resource>;
+  uuid: string;
+  category: "resource";
+  publicationDateTime: Date | null;
+  type: string;
+  number: number;
+  context: Context | null;
+  license: License | null;
+  copyright: string | null;
+  identification: Identification;
+  date: Date | null;
+  image: Image | null;
+  creators: Array<Person>;
+  notes: Array<Note>;
+  description: string;
+  document: Document | null;
+  href: string | null;
+  imageMap: ImageMap | null;
+  periods: Array<Period>;
+  format: string | null;
+  links: Array<Link>;
+  reverseLinks: Array<Link>;
+  properties: Array<Property>;
+  citedBibliographies: Array<Bibliography>;
+  resources: Array<Resource>;
 };
 /**
  * Represents a spatial unit with geographic coordinates and observations
  */
 type SpatialUnit = {
-    uuid: string;
-    category: "spatialUnit";
-    publicationDateTime: Date | null;
-    type: string;
-    number: number;
-    context: Context | null;
-    license: License | null;
-    identification: Identification;
-    image: Image | null;
-    description: string | null;
-    coordinates: Coordinates | null;
-    observations: Array<Observation>;
-    events: Array<Event>;
-    properties: Array<Property>;
+  uuid: string;
+  category: "spatialUnit";
+  publicationDateTime: Date | null;
+  type: string;
+  number: number;
+  context: Context | null;
+  license: License | null;
+  identification: Identification;
+  image: Image | null;
+  description: string | null;
+  coordinates: Coordinates | null;
+  observations: Array<Observation>;
+  events: Array<Event>;
+  properties: Array<Property>;
 };
 /**
  * Represents a concept with associated interpretations
  */
 type Concept = {
-    uuid: string;
-    category: "concept";
-    publicationDateTime: Date | null;
-    number: number;
-    license: License | null;
-    context: Context | null;
-    identification: Identification;
-    interpretations: Array<Interpretation>;
+  uuid: string;
+  category: "concept";
+  publicationDateTime: Date | null;
+  number: number;
+  license: License | null;
+  context: Context | null;
+  identification: Identification;
+  interpretations: Array<Interpretation>;
 };
 /**
  * Represents a set that can contain resources, spatial units and concepts
  */
 type Set<T extends DataCategory> = {
-    uuid: string;
-    category: "set";
-    itemCategory: T;
-    publicationDateTime: Date | null;
-    type: string;
-    number: number;
-    date: Date | null;
-    license: License | null;
-    identification: Identification;
-    isSuppressingBlanks: boolean;
-    description: string;
-    creators: Array<Person>;
-    items: T extends "resource" ? Array<Resource> : T extends "spatialUnit" ? Array<SpatialUnit> : T extends "concept" ? Array<Concept> : T extends "period" ? Array<Period> : T extends "bibliography" ? Array<Bibliography> : T extends "person" ? Array<Person> : T extends "propertyValue" ? Array<PropertyValue> : never;
+  uuid: string;
+  category: "set";
+  itemCategory: T;
+  publicationDateTime: Date | null;
+  type: string;
+  number: number;
+  date: Date | null;
+  license: License | null;
+  identification: Identification;
+  isSuppressingBlanks: boolean;
+  description: string;
+  creators: Array<Person>;
+  items: T extends "resource" ? Array<Resource> : T extends "spatialUnit" ? Array<SpatialUnit> : T extends "concept" ? Array<Concept> : T extends "period" ? Array<Period> : T extends "bibliography" ? Array<Bibliography> : T extends "person" ? Array<Person> : T extends "propertyValue" ? Array<PropertyValue> : never;
 };
 /**
  * Represents a bibliography entry with citation and publication information
  */
 type Bibliography = {
-    uuid: string;
-    category: "bibliography";
-    publicationDateTime: Date | null;
-    type: string | null;
-    number: number | null;
-    identification: Identification | null;
-    projectIdentification: Identification | null;
-    context: Context | null;
-    citation: {
-        format: string | null;
-        short: string | null;
-        long: string | null;
-    };
-    publicationInfo: {
-        publishers: Array<Person>;
-        startDate: Date | null;
-    };
-    entryInfo: {
-        startIssue: string;
-        startVolume: string;
-    } | null;
-    source: {
-        resource: Pick<Resource, "uuid" | "publicationDateTime" | "type" | "identification"> | null;
-        documentUrl: string | null;
-    };
-    periods: Array<Period>;
-    authors: Array<Person>;
-    properties: Array<Property>;
+  uuid: string;
+  category: "bibliography";
+  publicationDateTime: Date | null;
+  type: string | null;
+  number: number | null;
+  identification: Identification | null;
+  projectIdentification: Identification | null;
+  context: Context | null;
+  citation: {
+    format: string | null;
+    short: string | null;
+    long: string | null;
+  };
+  publicationInfo: {
+    publishers: Array<Person>;
+    startDate: Date | null;
+  };
+  entryInfo: {
+    startIssue: string;
+    startVolume: string;
+  } | null;
+  source: {
+    resource: Pick<Resource, "uuid" | "publicationDateTime" | "type" | "identification"> | null;
+    documentUrl: string | null;
+  };
+  periods: Array<Period>;
+  authors: Array<Person>;
+  properties: Array<Property>;
 };
 /**
  * Represents a time period with identification
  */
 type Period = {
-    uuid: string;
-    category: "period";
-    publicationDateTime: Date | null;
-    type: string | null;
-    number: number | null;
-    identification: Identification;
-    description: string | null;
+  uuid: string;
+  category: "period";
+  publicationDateTime: Date | null;
+  type: string | null;
+  number: number | null;
+  identification: Identification;
+  description: string | null;
 };
 /**
  * Represents a property value with type information
  */
 type PropertyValue = {
-    uuid: string;
-    category: "propertyValue";
-    number: number;
-    publicationDateTime: Date | null;
-    context: Context | null;
-    availability: License | null;
-    identification: Identification;
-    date: Date | null;
-    creators: Array<Person>;
-    description: string;
-    notes: Array<Note>;
-    links: Array<Link>;
+  uuid: string;
+  category: "propertyValue";
+  number: number;
+  publicationDateTime: Date | null;
+  context: Context | null;
+  availability: License | null;
+  identification: Identification;
+  date: Date | null;
+  creators: Array<Person>;
+  description: string;
+  notes: Array<Note>;
+  links: Array<Link>;
 };
 type PropertyValueContentType = "string" | "integer" | "decimal" | "boolean" | "date" | "dateTime" | "time" | "coordinate" | "IDREF";
 /**
  * Represents a property value with type information
  */
 type PropertyValueContent = {
-    content: string | number | boolean | Date | null;
-    booleanValue: boolean | null;
-    isUncertain: boolean;
-    type: PropertyValueContentType;
-    category: string;
-    uuid: string | null;
-    publicationDateTime: Date | null;
-    unit: string | null;
+  content: string | number | boolean | Date | null;
+  booleanValue: boolean | null;
+  isUncertain: boolean;
+  type: PropertyValueContentType;
+  category: string;
+  uuid: string | null;
+  publicationDateTime: Date | null;
+  unit: string | null;
 };
 /**
  * Represents a property with label, values and nested properties
  */
 type Property = {
-    uuid: string;
-    label: string;
-    values: Array<PropertyValueContent>;
-    comment: string | null;
-    properties: Array<Property>;
+  uuid: string;
+  label: string;
+  values: Array<PropertyValueContent>;
+  comment: string | null;
+  properties: Array<Property>;
 };
 /**
  * Represents a tree structure containing resources, spatial units and concepts
  */
 type Tree = {
-    uuid: string;
-    category: "tree";
-    publicationDateTime: Date | null;
-    type: string;
-    number: number;
-    date: Date | null;
-    license: License | null;
-    identification: Identification;
-    creators: Array<Person>;
-    items: {
-        resources: Array<Resource>;
-        spatialUnits: Array<SpatialUnit>;
-        concepts: Array<Concept>;
-        periods: Array<Period>;
-        bibliographies: Array<Bibliography>;
-        persons: Array<Person>;
-        propertyValues: Array<PropertyValue>;
-    };
-    properties: Array<Property>;
+  uuid: string;
+  category: "tree";
+  publicationDateTime: Date | null;
+  type: string;
+  number: number;
+  date: Date | null;
+  license: License | null;
+  identification: Identification;
+  creators: Array<Person>;
+  items: {
+    resources: Array<Resource>;
+    spatialUnits: Array<SpatialUnit>;
+    concepts: Array<Concept>;
+    periods: Array<Period>;
+    bibliographies: Array<Bibliography>;
+    persons: Array<Person>;
+    propertyValues: Array<PropertyValue>;
+  };
+  properties: Array<Property>;
 };
 /**
  * Represents a gallery with its identification, project identification, resources and max length
  */
 type Gallery = {
-    identification: Identification;
-    projectIdentification: Identification;
-    resources: Array<Resource>;
-    maxLength: number;
+  identification: Identification;
+  projectIdentification: Identification;
+  resources: Array<Resource>;
+  maxLength: number;
 };
 /**
  * Represents a website with its properties and elements
  */
 type Website = {
-    uuid: string;
-    publicationDateTime: Date | null;
-    identification: Identification;
-    project: {
-        name: string;
-        website: string | null;
+  uuid: string;
+  publicationDateTime: Date | null;
+  identification: Identification;
+  project: {
+    name: string;
+    website: string | null;
+  };
+  creators: Array<Person>;
+  license: License | null;
+  pages: Array<Webpage>;
+  sidebar: {
+    elements: Array<WebElement>;
+    title: WebElement["title"];
+    layout: "start" | "end";
+    mobileLayout: "default" | "inline";
+    cssStyles: Array<Style>;
+    cssStylesMobile: Array<Style>;
+  } | null;
+  properties: WebsiteProperties;
+  collectionOptions: {
+    uuids: Array<string>;
+    properties: {
+      metadataUuids: Array<string>;
+      searchUuids: Array<string>;
+      labelUuids: Array<string>;
     };
-    creators: Array<Person>;
-    license: License | null;
-    pages: Array<Webpage>;
-    sidebar: {
-        elements: Array<WebElement>;
-        title: WebElement["title"];
-        layout: "start" | "end";
-        mobileLayout: "default" | "inline";
-        cssStyles: Array<Style>;
-        cssStylesMobile: Array<Style>;
-    } | null;
-    properties: WebsiteProperties;
-    collectionOptions: {
-        uuids: Array<string>;
-        properties: {
-            metadataUuids: Array<string>;
-            searchUuids: Array<string>;
-            labelUuids: Array<string>;
-        };
-    } | null;
+  } | null;
 };
 /**
  * Properties for configuring website display and styling
  */
 type WebsiteProperties = {
-    type: "traditional" | "digital-collection" | "plum" | "cedar" | "elm" | "maple" | "oak" | "palm";
-    privacy: "public" | "password" | "private";
-    status: "development" | "preview" | "production";
-    contact: {
-        name: string;
-        email: string | null;
-    } | null;
-    isHeaderDisplayed: boolean;
-    headerVariant: "default" | "floating" | "inline";
-    headerAlignment: "start" | "center" | "end";
-    isHeaderProjectDisplayed: boolean;
-    isFooterDisplayed: boolean;
-    isSidebarDisplayed: boolean;
-    supportsThemeToggle: boolean;
-    logoUrl: string | null;
+  type: "traditional" | "digital-collection" | "plum" | "cedar" | "elm" | "maple" | "oak" | "palm";
+  privacy: "public" | "password" | "private";
+  status: "development" | "preview" | "production";
+  contact: {
+    name: string;
+    email: string | null;
+  } | null;
+  isHeaderDisplayed: boolean;
+  headerVariant: "default" | "floating" | "inline";
+  headerAlignment: "start" | "center" | "end";
+  isHeaderProjectDisplayed: boolean;
+  isFooterDisplayed: boolean;
+  isSidebarDisplayed: boolean;
+  supportsThemeToggle: boolean;
+  logoUrl: string | null;
 };
 type Webpage = {
-    title: string;
-    slug: string;
-    properties: WebpageProperties;
-    items: Array<WebElement | WebBlock>;
-    webpages: Array<Webpage>;
+  title: string;
+  slug: string;
+  properties: WebpageProperties;
+  items: Array<WebElement | WebBlock>;
+  webpages: Array<Webpage>;
 };
 /**
  * Properties for configuring webpage display and styling
  */
 type WebpageProperties = {
-    displayedInHeader: boolean;
-    width: "full" | "large" | "narrow" | "default";
-    variant: "default" | "no-background";
-    backgroundImageUrl: string | null;
-    isSidebarDisplayed: boolean;
-    cssStyles: Array<Style>;
-    cssStylesMobile: Array<Style>;
+  displayedInHeader: boolean;
+  width: "full" | "large" | "narrow" | "default";
+  variant: "default" | "no-background";
+  backgroundImageUrl: string | null;
+  isSidebarDisplayed: boolean;
+  cssStyles: Array<Style>;
+  cssStylesMobile: Array<Style>;
 };
 /**
  * Base properties for web elements
  */
 type WebElement = {
-    uuid: string;
-    type: "element";
-    title: {
-        label: string;
-        variant: "default" | "simple";
-        properties: {
-            isNameDisplayed: boolean;
-            isDescriptionDisplayed: boolean;
-            isDateDisplayed: boolean;
-            isCreatorsDisplayed: boolean;
-        };
+  uuid: string;
+  type: "element";
+  title: {
+    label: string;
+    variant: "default" | "simple";
+    properties: {
+      isNameDisplayed: boolean;
+      isDescriptionDisplayed: boolean;
+      isDateDisplayed: boolean;
+      isCreatorsDisplayed: boolean;
     };
-    isDisplayedInBlockSectionSidebar: boolean;
-    cssStyles: Array<Style>;
-    cssStylesMobile: Array<Style>;
+  };
+  isDisplayedInBlockSectionSidebar: boolean;
+  cssStyles: Array<Style>;
+  cssStylesMobile: Array<Style>;
 } & WebElementComponent;
 /**
  * Union type of all possible web element components
  */
 type WebElementComponent = {
-    component: "annotated-document";
-    document: Document;
+  component: "annotated-document";
+  document: Document;
 } | {
-    component: "annotated-image";
-    imageUuid: string;
-    isSearchable: boolean;
+  component: "annotated-image";
+  imageUuid: string;
+  isSearchable: boolean;
 } | {
-    component: "bibliography";
-    bibliographies: Array<Bibliography>;
-    layout: "long" | "short";
+  component: "bibliography";
+  bibliographies: Array<Bibliography>;
+  layout: "long" | "short";
 } | {
-    component: "entries";
-    entriesId: string;
-    variant: "entry" | "item";
-    isSearchable: boolean;
+  component: "entries";
+  entriesId: string;
+  variant: "entry" | "item";
+  isSearchable: boolean;
 } | {
-    component: "button";
-    variant: "default" | "transparent";
-    href: string;
-    isExternal: boolean;
-    label: string;
-    icon: string | null;
+  component: "button";
+  variant: "default" | "transparent";
+  href: string;
+  isExternal: boolean;
+  label: string;
+  icon: string | null;
 } | {
-    component: "collection";
-    collectionId: string;
-    variant: "full" | "highlights";
-    itemVariant: "default" | "card";
-    isSearchable: boolean;
-    showCount: boolean;
-    layout: "image-top" | "image-bottom" | "image-start" | "image-end";
+  component: "collection";
+  collectionId: string;
+  variant: "full" | "highlights";
+  itemVariant: "default" | "card";
+  isSearchable: boolean;
+  showCount: boolean;
+  layout: "image-top" | "image-bottom" | "image-start" | "image-end";
 } | {
-    component: "empty-space";
-    height: string | null;
-    width: string | null;
+  component: "empty-space";
+  height: string | null;
+  width: string | null;
 } | {
-    component: "filter-categories";
-    filterId: string;
+  component: "filter-categories";
+  filterId: string;
 } | {
-    component: "iframe";
-    href: string;
-    height: string | null;
-    width: string | null;
+  component: "iframe";
+  href: string;
+  height: string | null;
+  width: string | null;
 } | {
-    component: "iiif-viewer";
-    IIIFId: string;
+  component: "iiif-viewer";
+  IIIFId: string;
 } | {
-    component: "image";
-    images: Array<WebImage>;
-    variant: "default" | "carousel";
-    width: number | null;
-    height: number | null;
-    isFullWidth: boolean;
-    isFullHeight: boolean;
-    imageQuality: "high" | "low";
-    captionSource: "name" | "abbreviation" | "description";
-    captionLayout: "top" | "bottom" | "inset" | "suppress";
-    altTextSource: "name" | "abbreviation" | "description";
-    isTransparentBackground: boolean;
-    isCover: boolean;
-    carouselOptions: {
-        secondsPerImage: number;
-    } | null;
+  component: "image";
+  images: Array<WebImage>;
+  variant: "default" | "carousel";
+  width: number | null;
+  height: number | null;
+  isFullWidth: boolean;
+  isFullHeight: boolean;
+  imageQuality: "high" | "low";
+  captionSource: "name" | "abbreviation" | "description";
+  captionLayout: "top" | "bottom" | "inset" | "suppress";
+  altTextSource: "name" | "abbreviation" | "description";
+  isTransparentBackground: boolean;
+  isCover: boolean;
+  carouselOptions: {
+    secondsPerImage: number;
+  } | null;
 } | {
-    component: "image-gallery";
-    galleryId: string;
-    isSearchable: boolean;
+  component: "image-gallery";
+  galleryId: string;
+  isSearchable: boolean;
 } | {
-    component: "n-columns";
-    columns: Array<WebElement>;
+  component: "n-columns";
+  columns: Array<WebElement>;
 } | {
-    component: "n-rows";
-    rows: Array<WebElement>;
+  component: "n-rows";
+  rows: Array<WebElement>;
 } | {
-    component: "network-graph";
+  component: "network-graph";
 } | {
-    component: "search-bar";
-    variant: "default" | "full";
+  component: "search-bar";
+  variant: "default" | "full";
 } | {
-    component: "table";
-    tableId: string;
+  component: "table";
+  tableId: string;
 } | {
-    component: "text";
-    variant: "title" | "block" | "banner";
-    heading: "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | null;
-    content: string;
+  component: "text";
+  variant: "title" | "block" | "banner";
+  heading: "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | null;
+  content: string;
 } | {
-    component: "timeline";
-    timelineId: string;
+  component: "timeline";
+  timelineId: string;
 } | {
-    component: "video";
-    isChaptersDislayed: boolean;
+  component: "video";
+  isChaptersDislayed: boolean;
 };
 /**
  * Represents an image used in web elements
  */
 type WebImage = {
-    url: string;
-    label: string | null;
-    width: number;
-    height: number;
+  url: string;
+  label: string | null;
+  width: number;
+  height: number;
 };
 /**
  * Represents a CSS style with label and value
  */
 type Style = {
-    label: string;
-    value: string;
+  label: string;
+  value: string;
 };
 /**
  * Represents a block of vertical or horizontal content alignment
  */
 type WebBlock = {
-    uuid: string;
-    type: "block";
-    layout: "vertical" | "horizontal" | "grid";
-    items: Array<WebElement | WebBlock>;
-    properties: {
-        /**
-         * valid `gridTemplateColumns` or `gridTemplateRows` CSS property value
-         */
-        spacing: string | undefined;
-        /**
-         * `gap` CSS property value
-         */
-        gap: string | undefined;
-        /**
-         * `align-items` CSS property value
-         */
-        alignItems: "stretch" | "start" | "center" | "end" | "space-between";
-        /**
-         * `justify-content` CSS property value
-         */
-        justifyContent: "stretch" | "start" | "center" | "end" | "space-between";
-        sectionSidebarItems: Array<WebSectionSidebarItem> | null;
-    };
-    propertiesMobile: Record<string, string> | null;
-    cssStyles: Array<Style>;
-    cssStylesMobile: Array<Style>;
+  uuid: string;
+  type: "block";
+  layout: "vertical" | "horizontal" | "grid";
+  items: Array<WebElement | WebBlock>;
+  properties: {
+    /**
+     * valid `gridTemplateColumns` or `gridTemplateRows` CSS property value
+     */
+    spacing: string | undefined;
+    /**
+     * `gap` CSS property value
+     */
+    gap: string | undefined;
+    /**
+     * `align-items` CSS property value
+     */
+    alignItems: "stretch" | "start" | "center" | "end" | "space-between";
+    /**
+     * `justify-content` CSS property value
+     */
+    justifyContent: "stretch" | "start" | "center" | "end" | "space-between";
+    sectionSidebarItems: Array<WebSectionSidebarItem> | null;
+  };
+  propertiesMobile: Record<string, string> | null;
+  cssStyles: Array<Style>;
+  cssStylesMobile: Array<Style>;
 };
 type WebSectionSidebarItem = {
-    uuid: string;
-    type: "block" | "element";
-    name: string | null;
-    items: Array<WebSectionSidebarItem> | null;
-};
-
+  uuid: string;
+  type: "block" | "element";
+  name: string | null;
+  items: Array<WebSectionSidebarItem> | null;
+}; //#endregion
+//#region src/utils/fetchers/gallery.d.ts
 /**
  * Fetches and parses a gallery from the OCHRE API
  *
@@ -678,13 +682,15 @@ type WebSectionSidebarItem = {
  * - Resources (gallery items)
  */
 declare function fetchGallery(uuid: string, filter: string, page: number, perPage: number): Promise<{
-    item: Gallery | null;
-    error: null;
+  item: Gallery | null;
+  error: null;
 } | {
-    item: null;
-    error: string;
+  item: null;
+  error: string;
 }>;
 
+//#endregion
+//#region src/utils/fetchers/item.d.ts
 /**
  * Fetches and parses an OCHRE item from the OCHRE API
  *
@@ -719,27 +725,33 @@ declare function fetchGallery(uuid: string, filter: string, page: number, perPag
  * If the fetch/parse fails, the returned object will have an `error` property.
  */
 declare function fetchItem<T extends DataCategory, U extends DataCategory>(uuid: string, category?: T, setCategory?: T extends "set" ? U : never): Promise<{
-    error: null;
-    metadata: Metadata;
-    belongsTo: {
-        uuid: string;
-        abbreviation: string;
-    };
-    item: 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 "propertyValue" ? PropertyValue : T extends "set" ? Set<U> : T extends "tree" ? Tree : never;
-    category: T;
+  error: null;
+  metadata: Metadata;
+  belongsTo: {
+    uuid: string;
+    abbreviation: string;
+  };
+  item: 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 "propertyValue" ? PropertyValue : T extends "set" ? Set<U> : T extends "tree" ? Tree : never;
+  category: T;
 } | {
-    error: string;
-    metadata: never;
-    belongsTo: never;
-    item: never;
-    category: never;
+  error: string;
+  metadata: never;
+  belongsTo: never;
+  item: never;
+  category: never;
 }>;
 
+//#endregion
+//#region src/types/internal.raw.d.ts
 /**
  * Raw string value that can be a string, number, or boolean
  */
 type FakeString = string | number | boolean;
 
+/**
+ * Text rendering options for string content
+ */
+
 /**
  * Raw content item with rendering and whitespace options
  */
@@ -753,10 +765,7 @@ type OchreStringItemContent = {
  * Raw string item with language metadata
  */
 type OchreStringItem = {
-  string:
-    | FakeString
-    | OchreStringItemContent
-    | Array<FakeString | OchreStringItemContent>;
+  string: FakeString | OchreStringItemContent | Array<FakeString | OchreStringItemContent>;
   lang?: Language["iso6393"]; // 3 character code (zxx = "a.k.a.")
   languages?: string; // 3 character codes, semicolon separated
 };
@@ -791,19 +800,12 @@ type OchreStringRichTextItemAnnotation = {
 /**
  * Union type for different rich text item formats
  */
-type OchreStringRichTextItem =
-  | FakeString
-  | OchreStringRichTextItemContent
-  | {
-      string:
-        | OchreStringRichTextItemAnnotation
-        | Array<OchreStringRichTextItemAnnotation>;
-      whitespace?: string; // "newline" | "trailing" | "leading" (space separated)
-    }
-  | {
-      whitespace: string; // "newline" | "trailing" | "leading" (space separated)
-    }
-  | OchreStringRichTextItemAnnotation;
+type OchreStringRichTextItem = FakeString | OchreStringRichTextItemContent | {
+  string: OchreStringRichTextItemAnnotation | Array<OchreStringRichTextItemAnnotation>;
+  whitespace?: string; // "newline" | "trailing" | "leading" (space separated)
+} | {
+  whitespace: string; // "newline" | "trailing" | "leading" (space separated)
+} | OchreStringRichTextItemAnnotation;
 
 /**
  * Container for rich text content with language metadata
@@ -825,19 +827,31 @@ type OchreData = {
     publicationDateTime: string; // YYYY-MM-DDThh:mm:ssZ
     metadata: OchreMetadata;
     languages?: string; // 3 character codes, semicolon separated
-  } & (
-    | { tree: OchreTree }
-    | { set: OchreSet }
-    | { resource: OchreResource }
-    | { spatialUnit: OchreSpatialUnit }
-    | { concept: OchreConcept }
-    | { period: OchrePeriod }
-    | { bibliography: OchreBibliography }
-    | { person: OchrePerson }
-    | { propertyValue: OchrePropertyValue }
-  );
+  } & ({
+    tree: OchreTree;
+  } | {
+    set: OchreSet;
+  } | {
+    resource: OchreResource;
+  } | {
+    spatialUnit: OchreSpatialUnit;
+  } | {
+    concept: OchreConcept;
+  } | {
+    period: OchrePeriod;
+  } | {
+    bibliography: OchreBibliography;
+  } | {
+    person: OchrePerson;
+  } | {
+    propertyValue: OchrePropertyValue;
+  });
 };
 
+/**
+ * Raw data response structure from the OCHRE API
+ */
+
 /**
  * Raw metadata structure corresponding to the parsed Metadata type
  */
@@ -853,10 +867,16 @@ type OchreMetadata = {
   };
   publisher: OchreStringContent;
   dataset: OchreStringContent;
-  project?: { identification: OchreIdentification };
+  project?: {
+    identification: OchreIdentification;
+  };
   language?: OchreLanguage | Array<OchreLanguage>;
   description: OchreStringContent;
 };
+type OchreTreeCollectionOption = {
+  type: "set" | "variable";
+  content: string; // UUID
+};
 
 /**
  * Raw tree structure corresponding to the parsed Tree type
@@ -869,30 +889,38 @@ type OchreTree = {
   availability: OchreLicense;
   identification: OchreIdentification;
   date?: string; // YYYY-MM-DD
-  creators?: { creator: OchrePerson | Array<OchrePerson> };
-  searchOptions?: {
-    metadata?: {
-      option: string | Array<string>; // UUIDs
+  creators?: {
+    creator: OchrePerson | Array<OchrePerson>;
+  };
+  collectionOptions?: {
+    metadataUuids: {
+      uuid?: OchreTreeCollectionOption | Array<OchreTreeCollectionOption>;
     };
-    filters?: {
-      option: string | Array<string>; // UUIDs
+    searchUuids: {
+      uuid?: OchreTreeCollectionOption | Array<OchreTreeCollectionOption>;
     };
-    labels?: {
-      option: string | Array<string>; // UUIDs
+    labelUuids: {
+      uuid?: OchreTreeCollectionOption | Array<OchreTreeCollectionOption>;
     };
   };
-  items:
-    | string
-    | {
-        resource: OchreResource | Array<OchreResource>;
-      }
-    | { spatialUnit: OchreSpatialUnit | Array<OchreSpatialUnit> }
-    | { concept: OchreConcept | Array<OchreConcept> }
-    | { period: OchrePeriod | Array<OchrePeriod> }
-    | { bibliography: OchreBibliography | Array<OchreBibliography> }
-    | { person: OchrePerson | Array<OchrePerson> }
-    | { propertyValue: OchrePropertyValue | Array<OchrePropertyValue> };
-  properties?: { property: OchreProperty | Array<OchreProperty> };
+  items: string | {
+    resource: OchreResource | Array<OchreResource>;
+  } | {
+    spatialUnit: OchreSpatialUnit | Array<OchreSpatialUnit>;
+  } | {
+    concept: OchreConcept | Array<OchreConcept>;
+  } | {
+    period: OchrePeriod | Array<OchrePeriod>;
+  } | {
+    bibliography: OchreBibliography | Array<OchreBibliography>;
+  } | {
+    person: OchrePerson | Array<OchrePerson>;
+  } | {
+    propertyValue: OchrePropertyValue | Array<OchrePropertyValue>;
+  };
+  properties?: {
+    property: OchreProperty | Array<OchreProperty>;
+  };
 };
 
 /**
@@ -908,16 +936,24 @@ type OchreSet = {
   date?: string; // YYYY-MM-DD
   suppressBlanks?: boolean;
   description?: OchreStringContent | FakeString;
-  creators?: { creator: OchrePerson | Array<OchrePerson> };
-  items:
-    | string
-    | { resource: OchreResource | Array<OchreResource> }
-    | { spatialUnit: OchreSpatialUnit | Array<OchreSpatialUnit> }
-    | { concept: OchreConcept | Array<OchreConcept> }
-    | { period: OchrePeriod | Array<OchrePeriod> }
-    | { bibliography: OchreBibliography | Array<OchreBibliography> }
-    | { person: OchrePerson | Array<OchrePerson> }
-    | { propertyValue: OchrePropertyValue | Array<OchrePropertyValue> };
+  creators?: {
+    creator: OchrePerson | Array<OchrePerson>;
+  };
+  items: string | {
+    resource: OchreResource | Array<OchreResource>;
+  } | {
+    spatialUnit: OchreSpatialUnit | Array<OchreSpatialUnit>;
+  } | {
+    concept: OchreConcept | Array<OchreConcept>;
+  } | {
+    period: OchrePeriod | Array<OchrePeriod>;
+  } | {
+    bibliography: OchreBibliography | Array<OchreBibliography>;
+  } | {
+    person: OchrePerson | Array<OchrePerson>;
+  } | {
+    propertyValue: OchrePropertyValue | Array<OchrePropertyValue>;
+  };
 };
 
 /**
@@ -938,18 +974,24 @@ type OchreResource = {
   description?: OchreStringContent | FakeString;
   date?: string; // YYYY-MM-DD
   image?: OchreImage;
-  creators?: { creator: OchrePerson | Array<OchrePerson> };
-  notes?: { note: OchreNote | Array<OchreNote> };
-  document?:
-    | {
-        content: OchreStringRichText | Array<OchreStringRichText>;
-      }
-    | object;
+  creators?: {
+    creator: OchrePerson | Array<OchrePerson>;
+  };
+  notes?: {
+    note: OchreNote | Array<OchreNote>;
+  };
+  document?: {
+    content: OchreStringRichText | Array<OchreStringRichText>;
+  } | object;
   imagemap?: OchreImageMap;
-  periods?: { period: OchrePeriod | Array<OchrePeriod> };
+  periods?: {
+    period: OchrePeriod | Array<OchrePeriod>;
+  };
   links?: OchreLink | Array<OchreLink>;
   reverseLinks?: OchreLink | Array<OchreLink>;
-  properties?: { property: OchreProperty | Array<OchreProperty> };
+  properties?: {
+    property: OchreProperty | Array<OchreProperty>;
+  };
   citedBibliography?: {
     reference: OchreBibliography | Array<OchreBibliography>;
   };
@@ -971,10 +1013,16 @@ type OchreSpatialUnit = {
   description?: OchreStringContent | FakeString;
   coordinate?: string; // "latitude, longitude"
   coordinates?: OchreCoordinates;
-  events?: { event: OchreEvent | Array<OchreEvent> };
-  observations?: { observation: OchreObservation | Array<OchreObservation> };
+  events?: {
+    event: OchreEvent | Array<OchreEvent>;
+  };
+  observations?: {
+    observation: OchreObservation | Array<OchreObservation>;
+  };
   observation?: OchreObservation;
-  properties?: { property: OchreProperty | Array<OchreProperty> };
+  properties?: {
+    property: OchreProperty | Array<OchreProperty>;
+  };
 };
 
 /**
@@ -1011,11 +1059,10 @@ type OchrePropertyValueContent = {
  * Raw property structure corresponding to the parsed Property type
  */
 type OchreProperty = {
-  label: OchreStringContent & { uuid: string };
-  value?:
-    | OchrePropertyValueContent
-    | Array<OchrePropertyValueContent>
-    | FakeString;
+  label: OchreStringContent & {
+    uuid: string;
+  };
+  value?: OchrePropertyValueContent | Array<OchrePropertyValueContent> | FakeString;
   comment?: FakeString;
   property?: OchreProperty | Array<OchreProperty>;
 };
@@ -1039,7 +1086,10 @@ type OchreIdentification = {
  * Raw license structure corresponding to the parsed License type
  */
 type OchreLicense = {
-  license: { content: string; target: string } | string;
+  license: {
+    content: string;
+    target: string;
+  } | string;
 };
 
 /**
@@ -1071,16 +1121,25 @@ type OchreLinkItem = {
 /**
  * Raw link structure corresponding to the parsed Link type
  */
-type OchreLink =
-  | { resource: OchreLinkItem | Array<OchreLinkItem> }
-  | { spatialUnit: OchreLinkItem | Array<OchreLinkItem> }
-  | { concept: OchreLinkItem | Array<OchreLinkItem> }
-  | { set: OchreLinkItem | Array<OchreLinkItem> }
-  | { tree: OchreLinkItem | Array<OchreLinkItem> }
-  | { person: OchreLinkItem | Array<OchreLinkItem> }
-  | { epigraphicUnit: OchreLinkItem | Array<OchreLinkItem> }
-  | { bibliography: OchreBibliography | Array<OchreBibliography> }
-  | { propertyValue: OchreLinkItem | Array<OchreLinkItem> };
+type OchreLink = {
+  resource: OchreLinkItem | Array<OchreLinkItem>;
+} | {
+  spatialUnit: OchreLinkItem | Array<OchreLinkItem>;
+} | {
+  concept: OchreLinkItem | Array<OchreLinkItem>;
+} | {
+  set: OchreLinkItem | Array<OchreLinkItem>;
+} | {
+  tree: OchreLinkItem | Array<OchreLinkItem>;
+} | {
+  person: OchreLinkItem | Array<OchreLinkItem>;
+} | {
+  epigraphicUnit: OchreLinkItem | Array<OchreLinkItem>;
+} | {
+  bibliography: OchreBibliography | Array<OchreBibliography>;
+} | {
+  propertyValue: OchreLinkItem | Array<OchreLinkItem>;
+};
 
 /**
  * Raw image structure corresponding to the parsed Image type
@@ -1106,14 +1165,20 @@ type OchreBibliography = {
   type?: string;
   n?: number;
   identification?: OchreIdentification;
-  project?: { identification: OchreIdentification };
+  project?: {
+    identification: OchreIdentification;
+  };
   context?: OchreContext;
   sourceDocument?: {
     uuid: string;
     content: FakeString;
   };
   publicationInfo?: {
-    publishers?: { publishers: { person: OchrePerson | Array<OchrePerson> } };
+    publishers?: {
+      publishers: {
+        person: OchrePerson | Array<OchrePerson>;
+      };
+    };
     startDate?: {
       month: number;
       year: number;
@@ -1125,58 +1190,55 @@ type OchreBibliography = {
     startVolume: FakeString;
   };
   citationFormat?: string;
-  citationFormatSpan?:
-    | {
-        span: {
-          content: FakeString;
-        };
-      }
-    | {
-        "default:span": {
-          content: FakeString;
-        };
+  citationFormatSpan?: {
+    span: {
+      content: FakeString;
+    };
+  } | {
+    "default:span": {
+      content: FakeString;
+    };
+  };
+  referenceFormatDiv?: {
+    div: {
+      div: {
+        class: string;
+        content: FakeString;
       };
-  referenceFormatDiv?:
-    | {
-        div: {
-          div: {
-            class: string;
-            content: FakeString;
-          };
-          style: string;
-          class: string;
-        };
-      }
-    | {
-        "default:div": {
-          "default:div": {
-            class: string;
-            content: FakeString;
-          };
-          style: string;
-          class: string;
-        };
+      style: string;
+      class: string;
+    };
+  } | {
+    "default:div": {
+      "default:div": {
+        class: string;
+        content: FakeString;
       };
+      style: string;
+      class: string;
+    };
+  };
   source?: {
-    resource: Pick<
-      OchreResource,
-      "uuid" | "type" | "publicationDateTime" | "identification"
-    >;
+    resource: Pick<OchreResource, "uuid" | "type" | "publicationDateTime" | "identification">;
+  };
+  periods?: {
+    period: OchrePeriod | Array<OchrePeriod>;
+  };
+  authors?: {
+    person: OchrePerson | Array<OchrePerson>;
+  };
+  properties?: {
+    property: OchreProperty | Array<OchreProperty>;
   };
-  periods?: { period: OchrePeriod | Array<OchrePeriod> };
-  authors?: { person: OchrePerson | Array<OchrePerson> };
-  properties?: { property: OchreProperty | Array<OchreProperty> };
 };
 
 /**
  * Raw note structure corresponding to the parsed Note type
  */
-type OchreNote =
-  | string
-  | {
-      noteNo: number;
-      content: OchreStringRichText | Array<OchreStringRichText>;
-    };
+type OchreNote = string | {
+  noteNo: number;
+  content: OchreStringRichText | Array<OchreStringRichText>;
+};
 
 /**
  * Raw period structure corresponding to the parsed Period type
@@ -1258,8 +1320,12 @@ type OchrePerson = {
   };
   coordinates?: OchreCoordinates;
   content?: FakeString | null;
-  events?: { event: OchreEvent | Array<OchreEvent> };
-  properties?: { property: OchreProperty | Array<OchreProperty> };
+  events?: {
+    event: OchreEvent | Array<OchreEvent>;
+  };
+  properties?: {
+    property: OchreProperty | Array<OchreProperty>;
+  };
 };
 
 /**
@@ -1269,9 +1335,13 @@ type OchreObservation = {
   observationNo: number;
   date?: string; // YYYY-MM-DD
   observers?: FakeString;
-  notes?: { note: OchreNote | Array<OchreNote> };
+  notes?: {
+    note: OchreNote | Array<OchreNote>;
+  };
   links?: OchreLink | Array<OchreLink>;
-  properties?: { property: OchreProperty | Array<OchreProperty> };
+  properties?: {
+    property: OchreProperty | Array<OchreProperty>;
+  };
 };
 
 /**
@@ -1311,7 +1381,9 @@ type OchreEvent = {
 type OchreInterpretation = {
   date: string; // YYYY-MM-DD
   interpretationNo: number;
-  properties?: { property: OchreProperty | Array<OchreProperty> };
+  properties?: {
+    property: OchreProperty | Array<OchreProperty>;
+  };
 };
 
 /**
@@ -1325,12 +1397,21 @@ type OchrePropertyValue = {
   availability?: OchreLicense;
   identification: OchreIdentification;
   date?: string; // YYYY-MM-DD
-  creators?: { creator: OchrePerson | Array<OchrePerson> };
+  creators?: {
+    creator: OchrePerson | Array<OchrePerson>;
+  };
   description?: OchreStringContent | FakeString;
-  notes?: { note: OchreNote | Array<OchreNote> };
+  notes?: {
+    note: OchreNote | Array<OchreNote>;
+  };
   links?: OchreLink | Array<OchreLink>;
 };
 
+//#endregion
+//#region src/utils/fetchers/uuid.d.ts
+/**
+ * Raw gallery response structure
+ */
 /**
  * Fetches raw OCHRE data by UUID from the OCHRE API
  *
@@ -1351,6 +1432,8 @@ type OchrePropertyValue = {
  */
 declare function fetchByUuid(uuid: string): Promise<[null, OchreData] | [string, null]>;
 
+//#endregion
+//#region src/utils/fetchers/website.d.ts
 /**
  * Fetches and parses a website configuration from the OCHRE API
  *
@@ -1382,24 +1465,26 @@ declare function fetchByUuid(uuid: string): Promise<[null, OchreData] | [string,
  */
 declare function fetchWebsite(abbreviation: string): Promise<Website | null>;
 
+//#endregion
+//#region src/utils/getters.d.ts
 /**
  * Options for property search operations
  */
 type PropertyOptions = {
-    /** Whether to recursively search through nested properties */
-    searchNestedProperties: boolean;
+  /** Whether to recursively search through nested properties */
+  includeNestedProperties: boolean;
 };
 /**
  * Finds a property by its label in an array of properties
  *
  * @param properties - Array of properties to search through
  * @param label - The label to search for
- * @param options - Search options, including whether to search nested properties
+ * @param options - Search options, including whether to include nested properties
  * @returns The matching Property object, or null if not found
  *
  * @example
  * ```ts
- * const property = getPropertyByLabel(properties, "author", { searchNestedProperties: true });
+ * const property = getPropertyByLabel(properties, "author", { includeNestedProperties: true });
  * if (property) {
  *   console.log(property.values);
  * }
@@ -1411,7 +1496,7 @@ declare function getPropertyByLabel(properties: Array<Property>, label: string,
  *
  * @param properties - Array of properties to search through
  * @param label - The label to search for
- * @param options - Search options, including whether to search nested properties
+ * @param options - Search options, including whether to include nested properties
  * @returns Array of property values as strings, or null if property not found
  *
  * @example
@@ -1430,7 +1515,7 @@ declare function getPropertyValuesByLabel(properties: Array<Property>, label: st
  *
  * @param properties - Array of properties to search through
  * @param label - The label to search for
- * @param options - Search options, including whether to search nested properties
+ * @param options - Search options, including whether to include nested properties
  * @returns The first property value as string, or null if property not found
  *
  * @example
@@ -1443,19 +1528,19 @@ declare function getPropertyValuesByLabel(properties: Array<Property>, label: st
  */
 declare function getPropertyValueByLabel(properties: Array<Property>, label: string, options?: PropertyOptions): string | number | boolean | Date | null;
 /**
- * Gets all unique property labels from an array of properties
+ * Gets all unique properties from an array of properties
  *
- * @param properties - Array of properties to get labels from
- * @param options - Search options, including whether to include nested property labels
- * @returns Array of unique property labels
+ * @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
  *
  * @example
  * ```ts
- * const labels = getAllPropertyLabels(properties, { searchNestedProperties: true });
- * console.log(`Available properties: ${labels.join(", ")}`);
+ * const properties = getAllUniqueProperties(properties, { includeNestedProperties: true });
+ * console.log(`Available properties: ${properties.map((p) => p.label).join(", ")}`);
  * ```
  */
-declare function getAllPropertyLabels(properties: Array<Property>, options?: PropertyOptions): Array<string>;
+declare function getUniqueProperties(properties: Array<Property>, options?: PropertyOptions): Array<Property>;
 /**
  * Filters a property based on a label and value criteria
  *
@@ -1463,7 +1548,7 @@ declare function getAllPropertyLabels(properties: Array<Property>, options?: Pro
  * @param filter - Filter criteria containing label and value to match
  * @param filter.label - The label to filter by
  * @param filter.value - The value to filter by
- * @param options - Search options, including whether to search nested properties
+ * @param options - Search options, including whether to include nested properties
  * @returns True if the property matches the filter criteria, false otherwise
  *
  * @example
@@ -1478,10 +1563,12 @@ declare function getAllPropertyLabels(properties: Array<Property>, options?: Pro
  * ```
  */
 declare function filterProperties(property: Property, filter: {
-    label: string;
-    value: string | number | boolean | Date;
+  label: string;
+  value: string | number | boolean | Date;
 }, options?: PropertyOptions): boolean;
 
+//#endregion
+//#region src/utils/parse.d.ts
 /**
  * Parses raw identification data into the standardized Identification type
  *
@@ -1719,6 +1806,8 @@ declare function parseConcept(concept: OchreConcept): Concept;
 declare function parseConcepts(concepts: Array<OchreConcept>): Array<Concept>;
 declare function parseWebsite(websiteTree: OchreTree, projectName: FakeString, website: FakeString | null): Promise<Website>;
 
+//#endregion
+//#region src/utils/string.d.ts
 /**
  * Parses email addresses in a string into HTML links
  *
@@ -1770,4 +1859,5 @@ declare function parseStringDocumentItem(item: OchreStringRichTextItem, footnote
  */
 declare function parseStringContent(content: OchreStringContent, language?: string): string;
 
-export { type Bibliography, type Concept, type Context, type ContextItem, type ContextNode, type Coordinates, type Data, type DataCategory, type Document, type Event, type Footnote, type Gallery, type Identification, type Image, type ImageMap, type ImageMapArea, type Interpretation, type License, type Link, type Metadata, type Note, type Observation, type Period, type Person, type Property, type PropertyValue, type PropertyValueContent, type PropertyValueContentType, type Resource, type Set, type SpatialUnit, type Style, type Tree, type WebBlock, type WebElement, type WebElementComponent, type WebImage, type WebSectionSidebarItem, type Webpage, type WebpageProperties, type Website, type WebsiteProperties, fetchByUuid, fetchGallery, fetchItem, fetchWebsite, filterProperties, getAllPropertyLabels, getPropertyByLabel, getPropertyValueByLabel, getPropertyValuesByLabel, parseBibliographies, parseBibliography, parseConcept, parseConcepts, parseContext, parseCoordinates, parseDocument, parseEmail, parseEvents, parseFakeString, parseIdentification, parseImage, parseImageMap, parseInterpretations, parseLanguages, parseLicense, parseLink, parseLinks, parseMetadata, parseNotes, parseObservation, parseObservations, parsePeriod, parsePeriods, parsePerson, parsePersons, parseProperties, parseProperty, parsePropertyValue, parsePropertyValues, parseResource, parseResources, parseSet, parseSpatialUnit, parseSpatialUnits, parseStringContent, parseStringDocumentItem, parseStringItem, parseTree, parseWebsite };
+//#endregion
+export { Bibliography, Concept, Context, ContextItem, ContextNode, Coordinates, Data, DataCategory, Document, Event, Footnote, Gallery, Identification, Image, ImageMap, ImageMapArea, Interpretation, License, Link, Metadata, Note, Observation, Period, Person, Property, PropertyValue, PropertyValueContent, PropertyValueContentType, Resource, Set, SpatialUnit, Style, Tree, WebBlock, WebElement, WebElementComponent, WebImage, WebSectionSidebarItem, Webpage, WebpageProperties, Website, WebsiteProperties, fetchByUuid, fetchGallery, fetchItem, fetchWebsite, filterProperties, getPropertyByLabel, getPropertyValueByLabel, getPropertyValuesByLabel, getUniqueProperties, parseBibliographies, parseBibliography, parseConcept, parseConcepts, parseContext, parseCoordinates, parseDocument, parseEmail, parseEvents, parseFakeString, parseIdentification, parseImage, parseImageMap, parseInterpretations, parseLanguages, parseLicense, parseLink, parseLinks, parseMetadata, parseNotes, parseObservation, parseObservations, parsePeriod, parsePeriods, parsePerson, parsePersons, parseProperties, parseProperty, parsePropertyValue, parsePropertyValues, parseResource, parseResources, parseSet, parseSpatialUnit, parseSpatialUnits, parseStringContent, parseStringDocumentItem, parseStringItem, parseTree, parseWebsite };