@digitalculture/ochre-sdk 0.2.4 → 0.2.6

package/dist/index.cjs

@@ -59,6 +59,7 @@ __export(index_exports, {
   parseObservations: () => parseObservations,
   parsePeriod: () => parsePeriod,
   parsePeriods: () => parsePeriods,
+  parsePerson: () => parsePerson,
   parsePersons: () => parsePersons,
   parseProperties: () => parseProperties,
   parseResource: () => parseResource,
@@ -716,17 +717,20 @@ function parseLicense(license) {
     url: license.license.target
   };
 }
+function parsePerson(person) {
+  return {
+    uuid: person.uuid,
+    publicationDateTime: person.publicationDateTime != null ? new Date(person.publicationDateTime) : null,
+    type: person.type ?? null,
+    date: person.date != null ? new Date(person.date) : null,
+    identification: person.identification ? parseIdentification(person.identification) : null,
+    content: person.content != null ? parseFakeString(person.content) : null
+  };
+}
 function parsePersons(persons) {
   const returnPersons = [];
   for (const person of persons) {
-    returnPersons.push({
-      uuid: person.uuid,
-      publicationDateTime: person.publicationDateTime != null ? new Date(person.publicationDateTime) : null,
-      type: person.type ?? null,
-      date: person.date != null ? new Date(person.date) : null,
-      identification: person.identification ? parseIdentification(person.identification) : null,
-      content: person.content != null ? parseFakeString(person.content) : null
-    });
+    returnPersons.push(parsePerson(person));
   }
   return returnPersons;
 }
@@ -795,7 +799,11 @@ function parseImage(image) {
     identification: image.identification ? parseIdentification(image.identification) : null,
     url: image.href ?? (image.htmlImgSrcPrefix == null && image.content != null ? parseFakeString(image.content) : null),
     htmlPrefix: image.htmlImgSrcPrefix ?? null,
-    content: image.htmlImgSrcPrefix != null && image.content != null ? parseFakeString(image.content) : null
+    content: image.htmlImgSrcPrefix != null && image.content != null ? parseFakeString(image.content) : null,
+    widthPreview: image.widthPreview ?? null,
+    heightPreview: image.heightPreview ?? null,
+    width: image.width ?? null,
+    height: image.height ?? null
   };
 }
 function parseNotes(notes, language = "eng") {
@@ -889,13 +897,21 @@ function parseProperties(properties, language = "eng") {
   const returnProperties = [];
   for (const property of properties) {
     const valuesToParse = "value" in property && property.value ? Array.isArray(property.value) ? property.value : [property.value] : [];
-    const values = valuesToParse.map((value) => ({
-      content: parseStringContent(value),
-      type: value.type,
-      category: value.category !== "value" ? value.category ?? null : null,
-      uuid: value.uuid ?? null,
-      publicationDateTime: value.publicationDateTime != null ? new Date(value.publicationDateTime) : null
-    }));
+    const values = valuesToParse.map(
+      (value) => !["string", "number", "boolean"].includes(typeof value) && typeof value === "object" && "uuid" in value ? {
+        content: parseStringContent(value),
+        type: value.type,
+        category: value.category !== "value" ? value.category ?? null : null,
+        uuid: value.uuid ?? null,
+        publicationDateTime: value.publicationDateTime != null ? new Date(value.publicationDateTime) : null
+      } : {
+        content: parseFakeString(value),
+        type: "string",
+        category: "value",
+        uuid: null,
+        publicationDateTime: null
+      }
+    );
     returnProperties.push({
       label: parseStringContent(property.label, language).replace(/\s*\.{3}$/, "").trim(),
       values,
@@ -1041,6 +1057,7 @@ function parseTree(tree) {
   let concepts = [];
   let periods = [];
   let bibliographies = [];
+  let persons = [];
   if (typeof tree.items !== "string" && "resource" in tree.items) {
     resources = parseResources(
       Array.isArray(tree.items.resource) ? tree.items.resource : [tree.items.resource]
@@ -1066,6 +1083,11 @@ function parseTree(tree) {
       Array.isArray(tree.items.bibliography) ? tree.items.bibliography : [tree.items.bibliography]
     );
   }
+  if (typeof tree.items !== "string" && "person" in tree.items) {
+    persons = parsePersons(
+      Array.isArray(tree.items.person) ? tree.items.person : [tree.items.person]
+    );
+  }
   const returnTree = {
     uuid: tree.uuid,
     category: "tree",
@@ -1081,7 +1103,8 @@ function parseTree(tree) {
       spatialUnits,
       concepts,
       periods,
-      bibliographies
+      bibliographies,
+      persons
     },
     properties: tree.properties ? parseProperties(
       Array.isArray(tree.properties.property) ? tree.properties.property : [tree.properties.property]
@@ -1095,6 +1118,7 @@ function parseSet(set) {
   let concepts = [];
   let periods = [];
   let bibliographies = [];
+  let persons = [];
   if (typeof set.items !== "string" && "resource" in set.items) {
     resources = parseResources(
       Array.isArray(set.items.resource) ? set.items.resource : [set.items.resource],
@@ -1123,6 +1147,11 @@ function parseSet(set) {
       Array.isArray(set.items.bibliography) ? set.items.bibliography : [set.items.bibliography]
     );
   }
+  if (typeof set.items !== "string" && "person" in set.items) {
+    persons = parsePersons(
+      Array.isArray(set.items.person) ? set.items.person : [set.items.person]
+    );
+  }
   return {
     uuid: set.uuid,
     category: "set",
@@ -1142,7 +1171,8 @@ function parseSet(set) {
       spatialUnits,
       concepts,
       periods,
-      bibliographies
+      bibliographies,
+      persons
     }
   };
 }
@@ -1474,6 +1504,15 @@ async function parseWebElementProperties(componentProperty, elementResource) {
           `Image link not found for the following component: \u201C${componentName}\u201D`
         );
       }
+      const images = [];
+      for (const imageLink of imageLinks) {
+        images.push({
+          url: `https://ochre.lib.uchicago.edu/ochre?uuid=${imageLink.uuid}&load`,
+          label: imageLink.identification?.label ?? null,
+          width: imageLink.image?.width ?? 0,
+          height: imageLink.image?.height ?? 0
+        });
+      }
       let captionLayout = getPropertyValueByLabel(
         componentProperty.properties,
         "caption-layout"
@@ -1502,20 +1541,40 @@ async function parseWebElementProperties(componentProperty, elementResource) {
       if (altTextSource === null) {
         altTextSource = "name";
       }
-      const images = [];
-      for (const imageLink of imageLinks) {
-        images.push({
-          url: `https://ochre.lib.uchicago.edu/ochre?uuid=${imageLink.uuid}&load`,
-          label: imageLink.identification?.label ?? null,
-          width: imageLink.image?.width ?? 0,
-          height: imageLink.image?.height ?? 0
-        });
+      const carousel = images.length > 1 ? {
+        secondsPerImage: 5,
+        isFullWidth: false,
+        isFullHeight: false
+      } : null;
+      if (carousel !== null) {
+        const carouselSecondsPerImage = getPropertyValueByLabel(
+          componentProperty.properties,
+          "carousel-seconds-per-image"
+        );
+        if (carouselSecondsPerImage !== null) {
+          carousel.secondsPerImage = Number.parseFloat(carouselSecondsPerImage);
+        }
+        const carouselIsFullWidth = getPropertyValueByLabel(
+          componentProperty.properties,
+          "carousel-full-width"
+        );
+        if (carouselIsFullWidth !== null) {
+          carousel.isFullWidth = carouselIsFullWidth === "Yes";
+        }
+        const carouselIsFullHeight = getPropertyValueByLabel(
+          componentProperty.properties,
+          "carousel-full-height"
+        );
+        if (carouselIsFullHeight !== null) {
+          carousel.isFullHeight = carouselIsFullHeight === "Yes";
+        }
       }
       properties.images = images;
       properties.imageQuality = imageQuality;
       properties.captionLayout = captionLayout;
       properties.captionSource = captionSource;
       properties.altTextSource = altTextSource;
+      properties.carousel = carousel;
       break;
     }
     case "image-gallery": {
@@ -2299,6 +2358,7 @@ async function fetchWebsite(abbreviation) {
   parseObservations,
   parsePeriod,
   parsePeriods,
+  parsePerson,
   parsePersons,
   parseProperties,
   parseResource,

package/dist/index.d.cts

@@ -11,7 +11,7 @@ type Data = {
     };
     publicationDateTime: Date;
     metadata: Metadata;
-    item: Tree | Set | Resource | SpatialUnit | Concept;
+    item: Tree | Set | Resource | SpatialUnit | Concept | Period | Bibliography | Person;
 };
 /**
  * Basic identification information used across multiple types
@@ -100,6 +100,10 @@ type Image = {
     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
@@ -288,6 +292,7 @@ type Set = {
         concepts: Array<NestedConcept>;
         periods: Array<Period>;
         bibliographies: Array<Bibliography>;
+        persons: Array<Person>;
     };
 };
 /**
@@ -377,6 +382,7 @@ type Tree = {
         concepts: Array<Concept>;
         periods: Array<Period>;
         bibliographies: Array<Bibliography>;
+        persons: Array<Person>;
     };
     properties: Array<Property>;
 };
@@ -493,6 +499,11 @@ type WebElementComponent = {
     captionSource: "name" | "abbreviation" | "description";
     captionLayout: "top" | "bottom" | "suppress";
     altTextSource: "name" | "abbreviation" | "description";
+    carousel: {
+        secondsPerImage: number;
+        isFullWidth: boolean;
+        isFullHeight: boolean;
+    } | null;
 } | {
     component: "image-gallery";
     galleryId: string;
@@ -733,6 +744,7 @@ type OchreData = {
     | { concept: OchreConcept }
     | { period: OchrePeriod }
     | { bibliography: OchreBibliography }
+    | { person: OchrePerson }
   );
 };
 
@@ -776,7 +788,8 @@ type OchreTree = {
     | { spatialUnit: OchreSpatialUnit | Array<OchreSpatialUnit> }
     | { concept: OchreConcept | Array<OchreConcept> }
     | { period: OchrePeriod | Array<OchrePeriod> }
-    | { bibliography: OchreBibliography | Array<OchreBibliography> };
+    | { bibliography: OchreBibliography | Array<OchreBibliography> }
+    | { person: OchrePerson | Array<OchrePerson> };
   properties?: { property: OchreProperty | Array<OchreProperty> };
 };
 
@@ -800,7 +813,8 @@ type OchreSet = {
     | { spatialUnit: OchreSpatialUnit | Array<OchreSpatialUnit> }
     | { concept: OchreConcept | Array<OchreConcept> }
     | { period: OchrePeriod | Array<OchrePeriod> }
-    | { bibliography: OchreBibliography | Array<OchreBibliography> };
+    | { bibliography: OchreBibliography | Array<OchreBibliography> }
+    | { person: OchrePerson | Array<OchrePerson> };
 };
 
 /**
@@ -909,7 +923,7 @@ type OchrePropertyValue = OchreStringContent & {
  */
 type OchreProperty = {
   label: OchreStringContent & { uuid: string };
-  value?: OchrePropertyValue | Array<OchrePropertyValue>;
+  value?: OchrePropertyValue | Array<OchrePropertyValue> | FakeString;
   comment?: FakeString;
   property?: OchreProperty | Array<OchreProperty>;
 };
@@ -980,6 +994,10 @@ type OchreImage = {
   href?: string;
   htmlImgSrcPrefix?: string;
   content?: FakeString;
+  widthPreview?: number;
+  heightPreview?: number;
+  width?: number;
+  height?: number;
 };
 
 /**
@@ -1531,7 +1549,14 @@ declare function parseLicense(license: OchreLicense): License | null;
 /**
  * Parses raw person data into the standardized Person type
  *
- * @param persons - Raw person data from OCHRE format
+ * @param person - Raw person data from OCHRE format
+ * @returns Parsed Person object
+ */
+declare function parsePerson(person: OchrePerson): Person;
+/**
+ * Parses raw person data into the standardized Person type
+ *
+ * @param persons - Array of raw person data from OCHRE format
  * @returns Array of parsed Person objects
  */
 declare function parsePersons(persons: Array<OchrePerson>): Array<Person>;
@@ -1777,4 +1802,4 @@ declare function trimEndLineBreaks(string: string): string;
  */
 declare function parseStringContent(content: OchreStringContent, language?: string): string;
 
-export { type Bibliography, type Concept, type Context, type ContextItem, type ContextNode, type Coordinates, type Data, 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 NestedConcept, type NestedResource, type NestedSpatialUnit, type Note, type Observation, type Period, type Person, type Property, type PropertyValue, type PropertyValueType, type Resource, type Set, type SpatialUnit, type Style, type Tree, type WebElement, type WebElementComponent, type WebImage, type Webpage, type WebpageProperties, type Website, type WebsiteProperties, fetchBibliography, fetchByUuid, fetchConcept, fetchGallery, fetchPeriod, fetchResource, fetchSet, fetchSpatialUnit, fetchTree, fetchWebsite, filterProperties, getAllPropertyLabels, getPropertyByLabel, getPropertyValueByLabel, getPropertyValuesByLabel, parseBibliographies, parseBibliography, parseConcept, parseConcepts, parseContext, parseCoordinates, parseDocument, parseEmailAndUrl, parseEvents, parseFakeString, parseIdentification, parseImage, parseImageMap, parseInterpretations, parseLanguages, parseLicense, parseLink, parseLinks, parseMetadata, parseNotes, parseObservation, parseObservations, parsePeriod, parsePeriods, parsePersons, parseProperties, parseResource, parseResources, parseSet, parseSpatialUnit, parseSpatialUnits, parseStringContent, parseStringDocumentItem, parseStringItem, parseTree, parseWebsite, trimEndLineBreaks };
+export { type Bibliography, type Concept, type Context, type ContextItem, type ContextNode, type Coordinates, type Data, 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 NestedConcept, type NestedResource, type NestedSpatialUnit, type Note, type Observation, type Period, type Person, type Property, type PropertyValue, type PropertyValueType, type Resource, type Set, type SpatialUnit, type Style, type Tree, type WebElement, type WebElementComponent, type WebImage, type Webpage, type WebpageProperties, type Website, type WebsiteProperties, fetchBibliography, fetchByUuid, fetchConcept, fetchGallery, fetchPeriod, fetchResource, fetchSet, fetchSpatialUnit, fetchTree, fetchWebsite, filterProperties, getAllPropertyLabels, getPropertyByLabel, getPropertyValueByLabel, getPropertyValuesByLabel, parseBibliographies, parseBibliography, parseConcept, parseConcepts, parseContext, parseCoordinates, parseDocument, parseEmailAndUrl, parseEvents, parseFakeString, parseIdentification, parseImage, parseImageMap, parseInterpretations, parseLanguages, parseLicense, parseLink, parseLinks, parseMetadata, parseNotes, parseObservation, parseObservations, parsePeriod, parsePeriods, parsePerson, parsePersons, parseProperties, parseResource, parseResources, parseSet, parseSpatialUnit, parseSpatialUnits, parseStringContent, parseStringDocumentItem, parseStringItem, parseTree, parseWebsite, trimEndLineBreaks };

package/dist/index.d.ts

@@ -11,7 +11,7 @@ type Data = {
     };
     publicationDateTime: Date;
     metadata: Metadata;
-    item: Tree | Set | Resource | SpatialUnit | Concept;
+    item: Tree | Set | Resource | SpatialUnit | Concept | Period | Bibliography | Person;
 };
 /**
  * Basic identification information used across multiple types
@@ -100,6 +100,10 @@ type Image = {
     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
@@ -288,6 +292,7 @@ type Set = {
         concepts: Array<NestedConcept>;
         periods: Array<Period>;
         bibliographies: Array<Bibliography>;
+        persons: Array<Person>;
     };
 };
 /**
@@ -377,6 +382,7 @@ type Tree = {
         concepts: Array<Concept>;
         periods: Array<Period>;
         bibliographies: Array<Bibliography>;
+        persons: Array<Person>;
     };
     properties: Array<Property>;
 };
@@ -493,6 +499,11 @@ type WebElementComponent = {
     captionSource: "name" | "abbreviation" | "description";
     captionLayout: "top" | "bottom" | "suppress";
     altTextSource: "name" | "abbreviation" | "description";
+    carousel: {
+        secondsPerImage: number;
+        isFullWidth: boolean;
+        isFullHeight: boolean;
+    } | null;
 } | {
     component: "image-gallery";
     galleryId: string;
@@ -733,6 +744,7 @@ type OchreData = {
     | { concept: OchreConcept }
     | { period: OchrePeriod }
     | { bibliography: OchreBibliography }
+    | { person: OchrePerson }
   );
 };
 
@@ -776,7 +788,8 @@ type OchreTree = {
     | { spatialUnit: OchreSpatialUnit | Array<OchreSpatialUnit> }
     | { concept: OchreConcept | Array<OchreConcept> }
     | { period: OchrePeriod | Array<OchrePeriod> }
-    | { bibliography: OchreBibliography | Array<OchreBibliography> };
+    | { bibliography: OchreBibliography | Array<OchreBibliography> }
+    | { person: OchrePerson | Array<OchrePerson> };
   properties?: { property: OchreProperty | Array<OchreProperty> };
 };
 
@@ -800,7 +813,8 @@ type OchreSet = {
     | { spatialUnit: OchreSpatialUnit | Array<OchreSpatialUnit> }
     | { concept: OchreConcept | Array<OchreConcept> }
     | { period: OchrePeriod | Array<OchrePeriod> }
-    | { bibliography: OchreBibliography | Array<OchreBibliography> };
+    | { bibliography: OchreBibliography | Array<OchreBibliography> }
+    | { person: OchrePerson | Array<OchrePerson> };
 };
 
 /**
@@ -909,7 +923,7 @@ type OchrePropertyValue = OchreStringContent & {
  */
 type OchreProperty = {
   label: OchreStringContent & { uuid: string };
-  value?: OchrePropertyValue | Array<OchrePropertyValue>;
+  value?: OchrePropertyValue | Array<OchrePropertyValue> | FakeString;
   comment?: FakeString;
   property?: OchreProperty | Array<OchreProperty>;
 };
@@ -980,6 +994,10 @@ type OchreImage = {
   href?: string;
   htmlImgSrcPrefix?: string;
   content?: FakeString;
+  widthPreview?: number;
+  heightPreview?: number;
+  width?: number;
+  height?: number;
 };
 
 /**
@@ -1531,7 +1549,14 @@ declare function parseLicense(license: OchreLicense): License | null;
 /**
  * Parses raw person data into the standardized Person type
  *
- * @param persons - Raw person data from OCHRE format
+ * @param person - Raw person data from OCHRE format
+ * @returns Parsed Person object
+ */
+declare function parsePerson(person: OchrePerson): Person;
+/**
+ * Parses raw person data into the standardized Person type
+ *
+ * @param persons - Array of raw person data from OCHRE format
  * @returns Array of parsed Person objects
  */
 declare function parsePersons(persons: Array<OchrePerson>): Array<Person>;
@@ -1777,4 +1802,4 @@ declare function trimEndLineBreaks(string: string): string;
  */
 declare function parseStringContent(content: OchreStringContent, language?: string): string;
 
-export { type Bibliography, type Concept, type Context, type ContextItem, type ContextNode, type Coordinates, type Data, 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 NestedConcept, type NestedResource, type NestedSpatialUnit, type Note, type Observation, type Period, type Person, type Property, type PropertyValue, type PropertyValueType, type Resource, type Set, type SpatialUnit, type Style, type Tree, type WebElement, type WebElementComponent, type WebImage, type Webpage, type WebpageProperties, type Website, type WebsiteProperties, fetchBibliography, fetchByUuid, fetchConcept, fetchGallery, fetchPeriod, fetchResource, fetchSet, fetchSpatialUnit, fetchTree, fetchWebsite, filterProperties, getAllPropertyLabels, getPropertyByLabel, getPropertyValueByLabel, getPropertyValuesByLabel, parseBibliographies, parseBibliography, parseConcept, parseConcepts, parseContext, parseCoordinates, parseDocument, parseEmailAndUrl, parseEvents, parseFakeString, parseIdentification, parseImage, parseImageMap, parseInterpretations, parseLanguages, parseLicense, parseLink, parseLinks, parseMetadata, parseNotes, parseObservation, parseObservations, parsePeriod, parsePeriods, parsePersons, parseProperties, parseResource, parseResources, parseSet, parseSpatialUnit, parseSpatialUnits, parseStringContent, parseStringDocumentItem, parseStringItem, parseTree, parseWebsite, trimEndLineBreaks };
+export { type Bibliography, type Concept, type Context, type ContextItem, type ContextNode, type Coordinates, type Data, 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 NestedConcept, type NestedResource, type NestedSpatialUnit, type Note, type Observation, type Period, type Person, type Property, type PropertyValue, type PropertyValueType, type Resource, type Set, type SpatialUnit, type Style, type Tree, type WebElement, type WebElementComponent, type WebImage, type Webpage, type WebpageProperties, type Website, type WebsiteProperties, fetchBibliography, fetchByUuid, fetchConcept, fetchGallery, fetchPeriod, fetchResource, fetchSet, fetchSpatialUnit, fetchTree, fetchWebsite, filterProperties, getAllPropertyLabels, getPropertyByLabel, getPropertyValueByLabel, getPropertyValuesByLabel, parseBibliographies, parseBibliography, parseConcept, parseConcepts, parseContext, parseCoordinates, parseDocument, parseEmailAndUrl, parseEvents, parseFakeString, parseIdentification, parseImage, parseImageMap, parseInterpretations, parseLanguages, parseLicense, parseLink, parseLinks, parseMetadata, parseNotes, parseObservation, parseObservations, parsePeriod, parsePeriods, parsePerson, parsePersons, parseProperties, parseResource, parseResources, parseSet, parseSpatialUnit, parseSpatialUnits, parseStringContent, parseStringDocumentItem, parseStringItem, parseTree, parseWebsite, trimEndLineBreaks };

package/dist/index.js

@@ -639,17 +639,20 @@ function parseLicense(license) {
     url: license.license.target
   };
 }
+function parsePerson(person) {
+  return {
+    uuid: person.uuid,
+    publicationDateTime: person.publicationDateTime != null ? new Date(person.publicationDateTime) : null,
+    type: person.type ?? null,
+    date: person.date != null ? new Date(person.date) : null,
+    identification: person.identification ? parseIdentification(person.identification) : null,
+    content: person.content != null ? parseFakeString(person.content) : null
+  };
+}
 function parsePersons(persons) {
   const returnPersons = [];
   for (const person of persons) {
-    returnPersons.push({
-      uuid: person.uuid,
-      publicationDateTime: person.publicationDateTime != null ? new Date(person.publicationDateTime) : null,
-      type: person.type ?? null,
-      date: person.date != null ? new Date(person.date) : null,
-      identification: person.identification ? parseIdentification(person.identification) : null,
-      content: person.content != null ? parseFakeString(person.content) : null
-    });
+    returnPersons.push(parsePerson(person));
   }
   return returnPersons;
 }
@@ -718,7 +721,11 @@ function parseImage(image) {
     identification: image.identification ? parseIdentification(image.identification) : null,
     url: image.href ?? (image.htmlImgSrcPrefix == null && image.content != null ? parseFakeString(image.content) : null),
     htmlPrefix: image.htmlImgSrcPrefix ?? null,
-    content: image.htmlImgSrcPrefix != null && image.content != null ? parseFakeString(image.content) : null
+    content: image.htmlImgSrcPrefix != null && image.content != null ? parseFakeString(image.content) : null,
+    widthPreview: image.widthPreview ?? null,
+    heightPreview: image.heightPreview ?? null,
+    width: image.width ?? null,
+    height: image.height ?? null
   };
 }
 function parseNotes(notes, language = "eng") {
@@ -812,13 +819,21 @@ function parseProperties(properties, language = "eng") {
   const returnProperties = [];
   for (const property of properties) {
     const valuesToParse = "value" in property && property.value ? Array.isArray(property.value) ? property.value : [property.value] : [];
-    const values = valuesToParse.map((value) => ({
-      content: parseStringContent(value),
-      type: value.type,
-      category: value.category !== "value" ? value.category ?? null : null,
-      uuid: value.uuid ?? null,
-      publicationDateTime: value.publicationDateTime != null ? new Date(value.publicationDateTime) : null
-    }));
+    const values = valuesToParse.map(
+      (value) => !["string", "number", "boolean"].includes(typeof value) && typeof value === "object" && "uuid" in value ? {
+        content: parseStringContent(value),
+        type: value.type,
+        category: value.category !== "value" ? value.category ?? null : null,
+        uuid: value.uuid ?? null,
+        publicationDateTime: value.publicationDateTime != null ? new Date(value.publicationDateTime) : null
+      } : {
+        content: parseFakeString(value),
+        type: "string",
+        category: "value",
+        uuid: null,
+        publicationDateTime: null
+      }
+    );
     returnProperties.push({
       label: parseStringContent(property.label, language).replace(/\s*\.{3}$/, "").trim(),
       values,
@@ -964,6 +979,7 @@ function parseTree(tree) {
   let concepts = [];
   let periods = [];
   let bibliographies = [];
+  let persons = [];
   if (typeof tree.items !== "string" && "resource" in tree.items) {
     resources = parseResources(
       Array.isArray(tree.items.resource) ? tree.items.resource : [tree.items.resource]
@@ -989,6 +1005,11 @@ function parseTree(tree) {
       Array.isArray(tree.items.bibliography) ? tree.items.bibliography : [tree.items.bibliography]
     );
   }
+  if (typeof tree.items !== "string" && "person" in tree.items) {
+    persons = parsePersons(
+      Array.isArray(tree.items.person) ? tree.items.person : [tree.items.person]
+    );
+  }
   const returnTree = {
     uuid: tree.uuid,
     category: "tree",
@@ -1004,7 +1025,8 @@ function parseTree(tree) {
       spatialUnits,
       concepts,
       periods,
-      bibliographies
+      bibliographies,
+      persons
     },
     properties: tree.properties ? parseProperties(
       Array.isArray(tree.properties.property) ? tree.properties.property : [tree.properties.property]
@@ -1018,6 +1040,7 @@ function parseSet(set) {
   let concepts = [];
   let periods = [];
   let bibliographies = [];
+  let persons = [];
   if (typeof set.items !== "string" && "resource" in set.items) {
     resources = parseResources(
       Array.isArray(set.items.resource) ? set.items.resource : [set.items.resource],
@@ -1046,6 +1069,11 @@ function parseSet(set) {
       Array.isArray(set.items.bibliography) ? set.items.bibliography : [set.items.bibliography]
     );
   }
+  if (typeof set.items !== "string" && "person" in set.items) {
+    persons = parsePersons(
+      Array.isArray(set.items.person) ? set.items.person : [set.items.person]
+    );
+  }
   return {
     uuid: set.uuid,
     category: "set",
@@ -1065,7 +1093,8 @@ function parseSet(set) {
       spatialUnits,
       concepts,
       periods,
-      bibliographies
+      bibliographies,
+      persons
     }
   };
 }
@@ -1397,6 +1426,15 @@ async function parseWebElementProperties(componentProperty, elementResource) {
           `Image link not found for the following component: \u201C${componentName}\u201D`
         );
       }
+      const images = [];
+      for (const imageLink of imageLinks) {
+        images.push({
+          url: `https://ochre.lib.uchicago.edu/ochre?uuid=${imageLink.uuid}&load`,
+          label: imageLink.identification?.label ?? null,
+          width: imageLink.image?.width ?? 0,
+          height: imageLink.image?.height ?? 0
+        });
+      }
       let captionLayout = getPropertyValueByLabel(
         componentProperty.properties,
         "caption-layout"
@@ -1425,20 +1463,40 @@ async function parseWebElementProperties(componentProperty, elementResource) {
       if (altTextSource === null) {
         altTextSource = "name";
       }
-      const images = [];
-      for (const imageLink of imageLinks) {
-        images.push({
-          url: `https://ochre.lib.uchicago.edu/ochre?uuid=${imageLink.uuid}&load`,
-          label: imageLink.identification?.label ?? null,
-          width: imageLink.image?.width ?? 0,
-          height: imageLink.image?.height ?? 0
-        });
+      const carousel = images.length > 1 ? {
+        secondsPerImage: 5,
+        isFullWidth: false,
+        isFullHeight: false
+      } : null;
+      if (carousel !== null) {
+        const carouselSecondsPerImage = getPropertyValueByLabel(
+          componentProperty.properties,
+          "carousel-seconds-per-image"
+        );
+        if (carouselSecondsPerImage !== null) {
+          carousel.secondsPerImage = Number.parseFloat(carouselSecondsPerImage);
+        }
+        const carouselIsFullWidth = getPropertyValueByLabel(
+          componentProperty.properties,
+          "carousel-full-width"
+        );
+        if (carouselIsFullWidth !== null) {
+          carousel.isFullWidth = carouselIsFullWidth === "Yes";
+        }
+        const carouselIsFullHeight = getPropertyValueByLabel(
+          componentProperty.properties,
+          "carousel-full-height"
+        );
+        if (carouselIsFullHeight !== null) {
+          carousel.isFullHeight = carouselIsFullHeight === "Yes";
+        }
       }
       properties.images = images;
       properties.imageQuality = imageQuality;
       properties.captionLayout = captionLayout;
       properties.captionSource = captionSource;
       properties.altTextSource = altTextSource;
+      properties.carousel = carousel;
       break;
     }
     case "image-gallery": {
@@ -2221,6 +2279,7 @@ export {
   parseObservations,
   parsePeriod,
   parsePeriods,
+  parsePerson,
   parsePersons,
   parseProperties,
   parseResource,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitalculture/ochre-sdk",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "type": "module",
   "license": "MIT",
   "description": "Node.js library for working with OCHRE (Online Cultural and Historical Research Environment) data",
@@ -58,7 +58,7 @@
   },
   "scripts": {
     "dev": "tsup src/index.ts --watch",
-    "build:ochre-sdk": "tsup",
+    "build": "tsup",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --check .",
@@ -66,7 +66,7 @@
     "check-types": "tsc --noEmit",
     "check-exports": "attw --pack .",
     "test": "vitest run",
-    "ci": "pnpm run build:ochre-sdk && pnpm run lint && pnpm run format && pnpm run check-types && pnpm run check-exports && pnpm run test",
+    "ci": "pnpm run build && pnpm run lint && pnpm run format && pnpm run check-types && pnpm run check-exports && pnpm run test",
     "changeset": "changeset add",
     "release": "changeset version && changeset publish"
   }