@digitalculture/ochre-sdk 0.5.9 → 0.5.11

package/dist/index.cjs

@@ -62,6 +62,8 @@ __export(index_exports, {
   parsePerson: () => parsePerson,
   parsePersons: () => parsePersons,
   parseProperties: () => parseProperties,
+  parsePropertyValue: () => parsePropertyValue,
+  parsePropertyValues: () => parsePropertyValues,
   parseResource: () => parseResource,
   parseResources: () => parseResources,
   parseSet: () => parseSet,
@@ -571,10 +573,10 @@ var componentSchema = import_zod3.z.enum(
     "iiif-viewer",
     "image",
     "image-gallery",
-    "item-gallery",
     "n-columns",
     "n-rows",
     "network-graph",
+    "search-bar",
     "table",
     "text",
     "timeline",
@@ -713,7 +715,7 @@ function parsePersons(persons) {
   return returnPersons;
 }
 function parseLink(linkRaw) {
-  const links = "resource" in linkRaw ? linkRaw.resource : "spatialUnit" in linkRaw ? linkRaw.spatialUnit : "concept" in linkRaw ? linkRaw.concept : "set" in linkRaw ? linkRaw.set : "tree" in linkRaw ? linkRaw.tree : "person" in linkRaw ? linkRaw.person : "bibliography" in linkRaw ? linkRaw.bibliography : "epigraphicUnit" in linkRaw ? linkRaw.epigraphicUnit : null;
+  const links = "resource" in linkRaw ? linkRaw.resource : "spatialUnit" in linkRaw ? linkRaw.spatialUnit : "concept" in linkRaw ? linkRaw.concept : "set" in linkRaw ? linkRaw.set : "tree" in linkRaw ? linkRaw.tree : "person" in linkRaw ? linkRaw.person : "bibliography" in linkRaw ? linkRaw.bibliography : "epigraphicUnit" in linkRaw ? linkRaw.epigraphicUnit : "propertyValue" in linkRaw ? linkRaw.propertyValue : null;
   if (!links) {
     throw new Error(
       `Invalid link provided: ${JSON.stringify(linkRaw, null, 2)}`
@@ -723,7 +725,7 @@ function parseLink(linkRaw) {
   const returnLinks = [];
   for (const link of linksToParse) {
     const returnLink = {
-      category: "resource" in linkRaw ? "resource" : "spatialUnit" in linkRaw ? "spatialUnit" : "concept" in linkRaw ? "concept" : "set" in linkRaw ? "set" : "person" in linkRaw ? "person" : "tree" in linkRaw ? "tree" : "bibliography" in linkRaw ? "bibliography" : "epigraphicUnit" in linkRaw ? "epigraphicUnit" : null,
+      category: "resource" in linkRaw ? "resource" : "spatialUnit" in linkRaw ? "spatialUnit" : "concept" in linkRaw ? "concept" : "set" in linkRaw ? "set" : "person" in linkRaw ? "person" : "tree" in linkRaw ? "tree" : "bibliography" in linkRaw ? "bibliography" : "epigraphicUnit" in linkRaw ? "epigraphicUnit" : "propertyValue" in linkRaw ? "propertyValue" : null,
       content: "content" in link ? link.content != null ? parseFakeString(link.content) : null : null,
       href: "href" in link && link.href != null ? link.href : null,
       uuid: link.uuid,
@@ -1018,6 +1020,31 @@ function parseBibliographies(bibliographies) {
   }
   return returnBibliographies;
 }
+function parsePropertyValue(propertyValue) {
+  return {
+    uuid: propertyValue.uuid,
+    category: "propertyValue",
+    n: propertyValue.n,
+    publicationDateTime: propertyValue.publicationDateTime ? new Date(propertyValue.publicationDateTime) : null,
+    identification: parseIdentification(propertyValue.identification),
+    description: ["string", "number", "boolean"].includes(
+      typeof propertyValue.description
+    ) ? parseFakeString(propertyValue.description) : parseStringContent(propertyValue.description),
+    notes: propertyValue.notes ? parseNotes(
+      Array.isArray(propertyValue.notes.note) ? propertyValue.notes.note : [propertyValue.notes.note]
+    ) : [],
+    links: propertyValue.links ? parseLinks(
+      Array.isArray(propertyValue.links) ? propertyValue.links : [propertyValue.links]
+    ) : []
+  };
+}
+function parsePropertyValues(propertyValues) {
+  const returnPropertyValues = [];
+  for (const propertyValue of propertyValues) {
+    returnPropertyValues.push(parsePropertyValue(propertyValue));
+  }
+  return returnPropertyValues;
+}
 function parseTree(tree) {
   let creators = [];
   if (tree.creators) {
@@ -1035,6 +1062,7 @@ function parseTree(tree) {
   let periods = [];
   let bibliographies = [];
   let persons = [];
+  let propertyValues = [];
   if (typeof tree.items !== "string" && "resource" in tree.items) {
     resources = parseResources(
       Array.isArray(tree.items.resource) ? tree.items.resource : [tree.items.resource]
@@ -1065,6 +1093,11 @@ function parseTree(tree) {
       Array.isArray(tree.items.person) ? tree.items.person : [tree.items.person]
     );
   }
+  if (typeof tree.items !== "string" && "propertyValue" in tree.items) {
+    propertyValues = parsePropertyValues(
+      Array.isArray(tree.items.propertyValue) ? tree.items.propertyValue : [tree.items.propertyValue]
+    );
+  }
   const returnTree = {
     uuid: tree.uuid,
     category: "tree",
@@ -1081,7 +1114,8 @@ function parseTree(tree) {
       concepts,
       periods,
       bibliographies,
-      persons
+      persons,
+      propertyValues
     },
     properties: tree.properties ? parseProperties(
       Array.isArray(tree.properties.property) ? tree.properties.property : [tree.properties.property]
@@ -1096,6 +1130,7 @@ function parseSet(set) {
   let periods = [];
   let bibliographies = [];
   let persons = [];
+  let propertyValues = [];
   if (typeof set.items !== "string" && "resource" in set.items) {
     resources = parseResources(
       Array.isArray(set.items.resource) ? set.items.resource : [set.items.resource],
@@ -1129,6 +1164,11 @@ function parseSet(set) {
       Array.isArray(set.items.person) ? set.items.person : [set.items.person]
     );
   }
+  if (typeof set.items !== "string" && "propertyValue" in set.items) {
+    propertyValues = parsePropertyValues(
+      Array.isArray(set.items.propertyValue) ? set.items.propertyValue : [set.items.propertyValue]
+    );
+  }
   return {
     uuid: set.uuid,
     category: "set",
@@ -1149,7 +1189,8 @@ function parseSet(set) {
       concepts,
       periods,
       bibliographies,
-      persons
+      persons,
+      propertyValues
     }
   };
 }
@@ -1668,7 +1709,9 @@ async function parseWebElementProperties(componentProperty, elementResource) {
       break;
     }
     case "image-gallery": {
-      const galleryLink = links.find((link) => link.category === "tree");
+      const galleryLink = links.find(
+        (link) => link.category === "tree" || link.category === "set"
+      );
       if (!galleryLink) {
         throw new Error(
           `Image gallery link not found for the following component: \u201C${componentName}\u201D`
@@ -1682,21 +1725,6 @@ async function parseWebElementProperties(componentProperty, elementResource) {
       properties.isSearchable = isSearchable;
       break;
     }
-    case "item-gallery": {
-      const galleryLink = links.find((link) => link.category === "tree");
-      if (!galleryLink) {
-        throw new Error(
-          `Item gallery link not found for the following component: \u201C${componentName}\u201D`
-        );
-      }
-      const isSearchable = getPropertyValueByLabel(
-        componentProperty.properties,
-        "is-searchable"
-      ) === "Yes";
-      properties.galleryId = galleryLink.uuid;
-      properties.isSearchable = isSearchable;
-      break;
-    }
     case "n-columns": {
       const subElements = elementResource.resource ? await parseWebpageResources(
         Array.isArray(elementResource.resource) ? elementResource.resource : [elementResource.resource],
@@ -1726,6 +1754,15 @@ async function parseWebElementProperties(componentProperty, elementResource) {
       properties.tableId = tableLink.uuid;
       break;
     }
+    case "search-bar": {
+      let variant = getPropertyValueByLabel(
+        componentProperty.properties,
+        "variant"
+      );
+      variant ??= "default";
+      properties.variant = variant;
+      break;
+    }
     case "text": {
       if (!document) {
         throw new Error(
@@ -2663,6 +2700,8 @@ async function fetchWebsite(abbreviation) {
   parsePerson,
   parsePersons,
   parseProperties,
+  parsePropertyValue,
+  parsePropertyValues,
   parseResource,
   parseResources,
   parseSet,

package/dist/index.d.cts

@@ -11,7 +11,7 @@ type Data = {
     };
     publicationDateTime: Date;
     metadata: Metadata;
-    item: Tree | Set | Resource | SpatialUnit | Concept | Period | Bibliography | Person;
+    item: Tree | Set | Resource | SpatialUnit | Concept | Period | Bibliography | Person | PropertyValue;
 };
 /**
  * Basic identification information used across multiple types
@@ -112,7 +112,7 @@ type Link = {
     uuid: string;
     publicationDateTime: Date | null;
     type: string | null;
-    category: "resource" | "spatialUnit" | "concept" | "set" | "tree" | "person" | "bibliography" | "epigraphicUnit" | null;
+    category: "resource" | "spatialUnit" | "concept" | "set" | "tree" | "person" | "bibliography" | "epigraphicUnit" | "propertyValue" | null;
     identification: Identification | null;
     content: string | null;
     href: string | null;
@@ -295,6 +295,7 @@ type Set = {
         periods: Array<Period>;
         bibliographies: Array<Bibliography>;
         persons: Array<Person>;
+        propertyValues: Array<PropertyValue>;
     };
 };
 /**
@@ -343,15 +344,24 @@ type Period = {
     description: string | null;
 };
 /**
- * Valid types for property values
+ * Represents a property value with type information
  */
-type PropertyValueType = "string" | "number" | "integer" | "boolean" | "date" | "dateTime" | "time" | "IDREF";
+type PropertyValue = {
+    uuid: string;
+    category: "propertyValue";
+    n: number;
+    publicationDateTime: Date | null;
+    identification: Identification;
+    description: string;
+    notes: Array<Note>;
+    links: Array<Link>;
+};
 /**
  * Represents a property value with type information
  */
-type PropertyValue = {
+type PropertyValueContent = {
     content: string;
-    type: PropertyValueType;
+    type: "string" | "number" | "integer" | "boolean" | "date" | "dateTime" | "time" | "IDREF";
     category: string | null;
     uuid: string | null;
     publicationDateTime: Date | null;
@@ -361,7 +371,7 @@ type PropertyValue = {
  */
 type Property = {
     label: string;
-    values: Array<PropertyValue>;
+    values: Array<PropertyValueContent>;
     comment: string | null;
     properties: Array<Property>;
 };
@@ -385,6 +395,7 @@ type Tree = {
         periods: Array<Period>;
         bibliographies: Array<Bibliography>;
         persons: Array<Person>;
+        propertyValues: Array<PropertyValue>;
     };
     properties: Array<Property>;
 };
@@ -539,10 +550,6 @@ type WebElementComponent = {
     component: "image-gallery";
     galleryId: string;
     isSearchable: boolean;
-} | {
-    component: "item-gallery";
-    galleryId: string;
-    isSearchable: boolean;
 } | {
     component: "n-columns";
     columns: Array<WebElement>;
@@ -551,6 +558,9 @@ type WebElementComponent = {
     rows: Array<WebElement>;
 } | {
     component: "network-graph";
+} | {
+    component: "search-bar";
+    variant: "default" | "full";
 } | {
     component: "table";
     tableId: string;
@@ -800,6 +810,7 @@ type OchreData = {
     | { period: OchrePeriod }
     | { bibliography: OchreBibliography }
     | { person: OchrePerson }
+    | { propertyValue: OchrePropertyValue }
   );
 };
 
@@ -844,7 +855,8 @@ type OchreTree = {
     | { concept: OchreConcept | Array<OchreConcept> }
     | { period: OchrePeriod | Array<OchrePeriod> }
     | { bibliography: OchreBibliography | Array<OchreBibliography> }
-    | { person: OchrePerson | Array<OchrePerson> };
+    | { person: OchrePerson | Array<OchrePerson> }
+    | { propertyValue: OchrePropertyValue | Array<OchrePropertyValue> };
   properties?: { property: OchreProperty | Array<OchreProperty> };
 };
 
@@ -869,7 +881,8 @@ type OchreSet = {
     | { concept: OchreConcept | Array<OchreConcept> }
     | { period: OchrePeriod | Array<OchrePeriod> }
     | { bibliography: OchreBibliography | Array<OchreBibliography> }
-    | { person: OchrePerson | Array<OchrePerson> };
+    | { person: OchrePerson | Array<OchrePerson> }
+    | { propertyValue: OchrePropertyValue | Array<OchrePropertyValue> };
 };
 
 /**
@@ -966,7 +979,7 @@ type OchreNestedConcept = Omit<OchreConcept, "context" | "availability">;
 /**
  * Raw property value structure corresponding to the parsed PropertyValue type
  */
-type OchrePropertyValue = OchreStringContent & {
+type OchrePropertyValueContent = OchreStringContent & {
   uuid?: string;
   publicationDateTime?: string; // YYYY-MM-DDThh:mm:ssZ
   type: string;
@@ -979,7 +992,10 @@ type OchrePropertyValue = OchreStringContent & {
  */
 type OchreProperty = {
   label: OchreStringContent & { uuid: string };
-  value?: OchrePropertyValue | Array<OchrePropertyValue> | FakeString;
+  value?:
+    | OchrePropertyValueContent
+    | Array<OchrePropertyValueContent>
+    | FakeString;
   comment?: FakeString;
   property?: OchreProperty | Array<OchreProperty>;
 };
@@ -1042,7 +1058,8 @@ type OchreLink =
   | { tree: OchreLinkItem | Array<OchreLinkItem> }
   | { person: OchreLinkItem | Array<OchreLinkItem> }
   | { epigraphicUnit: OchreLinkItem | Array<OchreLinkItem> }
-  | { bibliography: OchreBibliography | Array<OchreBibliography> };
+  | { bibliography: OchreBibliography | Array<OchreBibliography> }
+  | { propertyValue: OchreLinkItem | Array<OchreLinkItem> };
 
 /**
  * Raw image structure corresponding to the parsed Image type
@@ -1263,6 +1280,19 @@ type OchreInterpretation = {
   properties?: { property: OchreProperty | Array<OchreProperty> };
 };
 
+/**
+ * Raw property value structure corresponding to the parsed PropertyValue type
+ */
+type OchrePropertyValue = {
+  uuid: string;
+  n: number;
+  publicationDateTime?: string; // YYYY-MM-DDThh:mm:ss
+  identification: OchreIdentification;
+  description: OchreStringContent | FakeString;
+  notes?: { note: OchreNote | Array<OchreNote> };
+  links?: OchreLink | Array<OchreLink>;
+};
+
 /**
  * Fetches raw OCHRE data by UUID from the OCHRE API
  *
@@ -1734,6 +1764,20 @@ declare function parseBibliography(bibliography: OchreBibliography): Bibliograph
  * @returns Array of parsed Bibliography objects
  */
 declare function parseBibliographies(bibliographies: Array<OchreBibliography>): Array<Bibliography>;
+/**
+ * Parses raw property value data into a standardized PropertyValue structure
+ *
+ * @param propertyValue - Raw property value data in OCHRE format
+ * @returns Parsed PropertyValue object
+ */
+declare function parsePropertyValue(propertyValue: OchrePropertyValue): PropertyValue;
+/**
+ * Parses an array of raw property values into standardized PropertyValue objects
+ *
+ * @param propertyValues - Array of raw property values in OCHRE format
+ * @returns Array of parsed PropertyValue objects
+ */
+declare function parsePropertyValues(propertyValues: Array<OchrePropertyValue>): Array<PropertyValue>;
 /**
  * Parses a raw tree structure into a standardized Tree object
  *
@@ -1847,4 +1891,4 @@ 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 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 WebBlock, 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, parseEmail, 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 };
+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 PropertyValueContent, type Resource, type Set, type SpatialUnit, type Style, type Tree, type WebBlock, 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, parseEmail, parseEvents, parseFakeString, parseIdentification, parseImage, parseImageMap, parseInterpretations, parseLanguages, parseLicense, parseLink, parseLinks, parseMetadata, parseNotes, parseObservation, parseObservations, parsePeriod, parsePeriods, parsePerson, parsePersons, parseProperties, parsePropertyValue, parsePropertyValues, parseResource, parseResources, parseSet, parseSpatialUnit, parseSpatialUnits, parseStringContent, parseStringDocumentItem, parseStringItem, parseTree, parseWebsite };

package/dist/index.d.ts

@@ -11,7 +11,7 @@ type Data = {
     };
     publicationDateTime: Date;
     metadata: Metadata;
-    item: Tree | Set | Resource | SpatialUnit | Concept | Period | Bibliography | Person;
+    item: Tree | Set | Resource | SpatialUnit | Concept | Period | Bibliography | Person | PropertyValue;
 };
 /**
  * Basic identification information used across multiple types
@@ -112,7 +112,7 @@ type Link = {
     uuid: string;
     publicationDateTime: Date | null;
     type: string | null;
-    category: "resource" | "spatialUnit" | "concept" | "set" | "tree" | "person" | "bibliography" | "epigraphicUnit" | null;
+    category: "resource" | "spatialUnit" | "concept" | "set" | "tree" | "person" | "bibliography" | "epigraphicUnit" | "propertyValue" | null;
     identification: Identification | null;
     content: string | null;
     href: string | null;
@@ -295,6 +295,7 @@ type Set = {
         periods: Array<Period>;
         bibliographies: Array<Bibliography>;
         persons: Array<Person>;
+        propertyValues: Array<PropertyValue>;
     };
 };
 /**
@@ -343,15 +344,24 @@ type Period = {
     description: string | null;
 };
 /**
- * Valid types for property values
+ * Represents a property value with type information
  */
-type PropertyValueType = "string" | "number" | "integer" | "boolean" | "date" | "dateTime" | "time" | "IDREF";
+type PropertyValue = {
+    uuid: string;
+    category: "propertyValue";
+    n: number;
+    publicationDateTime: Date | null;
+    identification: Identification;
+    description: string;
+    notes: Array<Note>;
+    links: Array<Link>;
+};
 /**
  * Represents a property value with type information
  */
-type PropertyValue = {
+type PropertyValueContent = {
     content: string;
-    type: PropertyValueType;
+    type: "string" | "number" | "integer" | "boolean" | "date" | "dateTime" | "time" | "IDREF";
     category: string | null;
     uuid: string | null;
     publicationDateTime: Date | null;
@@ -361,7 +371,7 @@ type PropertyValue = {
  */
 type Property = {
     label: string;
-    values: Array<PropertyValue>;
+    values: Array<PropertyValueContent>;
     comment: string | null;
     properties: Array<Property>;
 };
@@ -385,6 +395,7 @@ type Tree = {
         periods: Array<Period>;
         bibliographies: Array<Bibliography>;
         persons: Array<Person>;
+        propertyValues: Array<PropertyValue>;
     };
     properties: Array<Property>;
 };
@@ -539,10 +550,6 @@ type WebElementComponent = {
     component: "image-gallery";
     galleryId: string;
     isSearchable: boolean;
-} | {
-    component: "item-gallery";
-    galleryId: string;
-    isSearchable: boolean;
 } | {
     component: "n-columns";
     columns: Array<WebElement>;
@@ -551,6 +558,9 @@ type WebElementComponent = {
     rows: Array<WebElement>;
 } | {
     component: "network-graph";
+} | {
+    component: "search-bar";
+    variant: "default" | "full";
 } | {
     component: "table";
     tableId: string;
@@ -800,6 +810,7 @@ type OchreData = {
     | { period: OchrePeriod }
     | { bibliography: OchreBibliography }
     | { person: OchrePerson }
+    | { propertyValue: OchrePropertyValue }
   );
 };
 
@@ -844,7 +855,8 @@ type OchreTree = {
     | { concept: OchreConcept | Array<OchreConcept> }
     | { period: OchrePeriod | Array<OchrePeriod> }
     | { bibliography: OchreBibliography | Array<OchreBibliography> }
-    | { person: OchrePerson | Array<OchrePerson> };
+    | { person: OchrePerson | Array<OchrePerson> }
+    | { propertyValue: OchrePropertyValue | Array<OchrePropertyValue> };
   properties?: { property: OchreProperty | Array<OchreProperty> };
 };
 
@@ -869,7 +881,8 @@ type OchreSet = {
     | { concept: OchreConcept | Array<OchreConcept> }
     | { period: OchrePeriod | Array<OchrePeriod> }
     | { bibliography: OchreBibliography | Array<OchreBibliography> }
-    | { person: OchrePerson | Array<OchrePerson> };
+    | { person: OchrePerson | Array<OchrePerson> }
+    | { propertyValue: OchrePropertyValue | Array<OchrePropertyValue> };
 };
 
 /**
@@ -966,7 +979,7 @@ type OchreNestedConcept = Omit<OchreConcept, "context" | "availability">;
 /**
  * Raw property value structure corresponding to the parsed PropertyValue type
  */
-type OchrePropertyValue = OchreStringContent & {
+type OchrePropertyValueContent = OchreStringContent & {
   uuid?: string;
   publicationDateTime?: string; // YYYY-MM-DDThh:mm:ssZ
   type: string;
@@ -979,7 +992,10 @@ type OchrePropertyValue = OchreStringContent & {
  */
 type OchreProperty = {
   label: OchreStringContent & { uuid: string };
-  value?: OchrePropertyValue | Array<OchrePropertyValue> | FakeString;
+  value?:
+    | OchrePropertyValueContent
+    | Array<OchrePropertyValueContent>
+    | FakeString;
   comment?: FakeString;
   property?: OchreProperty | Array<OchreProperty>;
 };
@@ -1042,7 +1058,8 @@ type OchreLink =
   | { tree: OchreLinkItem | Array<OchreLinkItem> }
   | { person: OchreLinkItem | Array<OchreLinkItem> }
   | { epigraphicUnit: OchreLinkItem | Array<OchreLinkItem> }
-  | { bibliography: OchreBibliography | Array<OchreBibliography> };
+  | { bibliography: OchreBibliography | Array<OchreBibliography> }
+  | { propertyValue: OchreLinkItem | Array<OchreLinkItem> };
 
 /**
  * Raw image structure corresponding to the parsed Image type
@@ -1263,6 +1280,19 @@ type OchreInterpretation = {
   properties?: { property: OchreProperty | Array<OchreProperty> };
 };
 
+/**
+ * Raw property value structure corresponding to the parsed PropertyValue type
+ */
+type OchrePropertyValue = {
+  uuid: string;
+  n: number;
+  publicationDateTime?: string; // YYYY-MM-DDThh:mm:ss
+  identification: OchreIdentification;
+  description: OchreStringContent | FakeString;
+  notes?: { note: OchreNote | Array<OchreNote> };
+  links?: OchreLink | Array<OchreLink>;
+};
+
 /**
  * Fetches raw OCHRE data by UUID from the OCHRE API
  *
@@ -1734,6 +1764,20 @@ declare function parseBibliography(bibliography: OchreBibliography): Bibliograph
  * @returns Array of parsed Bibliography objects
  */
 declare function parseBibliographies(bibliographies: Array<OchreBibliography>): Array<Bibliography>;
+/**
+ * Parses raw property value data into a standardized PropertyValue structure
+ *
+ * @param propertyValue - Raw property value data in OCHRE format
+ * @returns Parsed PropertyValue object
+ */
+declare function parsePropertyValue(propertyValue: OchrePropertyValue): PropertyValue;
+/**
+ * Parses an array of raw property values into standardized PropertyValue objects
+ *
+ * @param propertyValues - Array of raw property values in OCHRE format
+ * @returns Array of parsed PropertyValue objects
+ */
+declare function parsePropertyValues(propertyValues: Array<OchrePropertyValue>): Array<PropertyValue>;
 /**
  * Parses a raw tree structure into a standardized Tree object
  *
@@ -1847,4 +1891,4 @@ 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 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 WebBlock, 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, parseEmail, 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 };
+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 PropertyValueContent, type Resource, type Set, type SpatialUnit, type Style, type Tree, type WebBlock, 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, parseEmail, parseEvents, parseFakeString, parseIdentification, parseImage, parseImageMap, parseInterpretations, parseLanguages, parseLicense, parseLink, parseLinks, parseMetadata, parseNotes, parseObservation, parseObservations, parsePeriod, parsePeriods, parsePerson, parsePersons, parseProperties, parsePropertyValue, parsePropertyValues, parseResource, parseResources, parseSet, parseSpatialUnit, parseSpatialUnits, parseStringContent, parseStringDocumentItem, parseStringItem, parseTree, parseWebsite };

package/dist/index.js

@@ -494,10 +494,10 @@ var componentSchema = z3.enum(
     "iiif-viewer",
     "image",
     "image-gallery",
-    "item-gallery",
     "n-columns",
     "n-rows",
     "network-graph",
+    "search-bar",
     "table",
     "text",
     "timeline",
@@ -636,7 +636,7 @@ function parsePersons(persons) {
   return returnPersons;
 }
 function parseLink(linkRaw) {
-  const links = "resource" in linkRaw ? linkRaw.resource : "spatialUnit" in linkRaw ? linkRaw.spatialUnit : "concept" in linkRaw ? linkRaw.concept : "set" in linkRaw ? linkRaw.set : "tree" in linkRaw ? linkRaw.tree : "person" in linkRaw ? linkRaw.person : "bibliography" in linkRaw ? linkRaw.bibliography : "epigraphicUnit" in linkRaw ? linkRaw.epigraphicUnit : null;
+  const links = "resource" in linkRaw ? linkRaw.resource : "spatialUnit" in linkRaw ? linkRaw.spatialUnit : "concept" in linkRaw ? linkRaw.concept : "set" in linkRaw ? linkRaw.set : "tree" in linkRaw ? linkRaw.tree : "person" in linkRaw ? linkRaw.person : "bibliography" in linkRaw ? linkRaw.bibliography : "epigraphicUnit" in linkRaw ? linkRaw.epigraphicUnit : "propertyValue" in linkRaw ? linkRaw.propertyValue : null;
   if (!links) {
     throw new Error(
       `Invalid link provided: ${JSON.stringify(linkRaw, null, 2)}`
@@ -646,7 +646,7 @@ function parseLink(linkRaw) {
   const returnLinks = [];
   for (const link of linksToParse) {
     const returnLink = {
-      category: "resource" in linkRaw ? "resource" : "spatialUnit" in linkRaw ? "spatialUnit" : "concept" in linkRaw ? "concept" : "set" in linkRaw ? "set" : "person" in linkRaw ? "person" : "tree" in linkRaw ? "tree" : "bibliography" in linkRaw ? "bibliography" : "epigraphicUnit" in linkRaw ? "epigraphicUnit" : null,
+      category: "resource" in linkRaw ? "resource" : "spatialUnit" in linkRaw ? "spatialUnit" : "concept" in linkRaw ? "concept" : "set" in linkRaw ? "set" : "person" in linkRaw ? "person" : "tree" in linkRaw ? "tree" : "bibliography" in linkRaw ? "bibliography" : "epigraphicUnit" in linkRaw ? "epigraphicUnit" : "propertyValue" in linkRaw ? "propertyValue" : null,
       content: "content" in link ? link.content != null ? parseFakeString(link.content) : null : null,
       href: "href" in link && link.href != null ? link.href : null,
       uuid: link.uuid,
@@ -941,6 +941,31 @@ function parseBibliographies(bibliographies) {
   }
   return returnBibliographies;
 }
+function parsePropertyValue(propertyValue) {
+  return {
+    uuid: propertyValue.uuid,
+    category: "propertyValue",
+    n: propertyValue.n,
+    publicationDateTime: propertyValue.publicationDateTime ? new Date(propertyValue.publicationDateTime) : null,
+    identification: parseIdentification(propertyValue.identification),
+    description: ["string", "number", "boolean"].includes(
+      typeof propertyValue.description
+    ) ? parseFakeString(propertyValue.description) : parseStringContent(propertyValue.description),
+    notes: propertyValue.notes ? parseNotes(
+      Array.isArray(propertyValue.notes.note) ? propertyValue.notes.note : [propertyValue.notes.note]
+    ) : [],
+    links: propertyValue.links ? parseLinks(
+      Array.isArray(propertyValue.links) ? propertyValue.links : [propertyValue.links]
+    ) : []
+  };
+}
+function parsePropertyValues(propertyValues) {
+  const returnPropertyValues = [];
+  for (const propertyValue of propertyValues) {
+    returnPropertyValues.push(parsePropertyValue(propertyValue));
+  }
+  return returnPropertyValues;
+}
 function parseTree(tree) {
   let creators = [];
   if (tree.creators) {
@@ -958,6 +983,7 @@ function parseTree(tree) {
   let periods = [];
   let bibliographies = [];
   let persons = [];
+  let propertyValues = [];
   if (typeof tree.items !== "string" && "resource" in tree.items) {
     resources = parseResources(
       Array.isArray(tree.items.resource) ? tree.items.resource : [tree.items.resource]
@@ -988,6 +1014,11 @@ function parseTree(tree) {
       Array.isArray(tree.items.person) ? tree.items.person : [tree.items.person]
     );
   }
+  if (typeof tree.items !== "string" && "propertyValue" in tree.items) {
+    propertyValues = parsePropertyValues(
+      Array.isArray(tree.items.propertyValue) ? tree.items.propertyValue : [tree.items.propertyValue]
+    );
+  }
   const returnTree = {
     uuid: tree.uuid,
     category: "tree",
@@ -1004,7 +1035,8 @@ function parseTree(tree) {
       concepts,
       periods,
       bibliographies,
-      persons
+      persons,
+      propertyValues
     },
     properties: tree.properties ? parseProperties(
       Array.isArray(tree.properties.property) ? tree.properties.property : [tree.properties.property]
@@ -1019,6 +1051,7 @@ function parseSet(set) {
   let periods = [];
   let bibliographies = [];
   let persons = [];
+  let propertyValues = [];
   if (typeof set.items !== "string" && "resource" in set.items) {
     resources = parseResources(
       Array.isArray(set.items.resource) ? set.items.resource : [set.items.resource],
@@ -1052,6 +1085,11 @@ function parseSet(set) {
       Array.isArray(set.items.person) ? set.items.person : [set.items.person]
     );
   }
+  if (typeof set.items !== "string" && "propertyValue" in set.items) {
+    propertyValues = parsePropertyValues(
+      Array.isArray(set.items.propertyValue) ? set.items.propertyValue : [set.items.propertyValue]
+    );
+  }
   return {
     uuid: set.uuid,
     category: "set",
@@ -1072,7 +1110,8 @@ function parseSet(set) {
       concepts,
       periods,
       bibliographies,
-      persons
+      persons,
+      propertyValues
     }
   };
 }
@@ -1591,7 +1630,9 @@ async function parseWebElementProperties(componentProperty, elementResource) {
       break;
     }
     case "image-gallery": {
-      const galleryLink = links.find((link) => link.category === "tree");
+      const galleryLink = links.find(
+        (link) => link.category === "tree" || link.category === "set"
+      );
       if (!galleryLink) {
         throw new Error(
           `Image gallery link not found for the following component: \u201C${componentName}\u201D`
@@ -1605,21 +1646,6 @@ async function parseWebElementProperties(componentProperty, elementResource) {
       properties.isSearchable = isSearchable;
       break;
     }
-    case "item-gallery": {
-      const galleryLink = links.find((link) => link.category === "tree");
-      if (!galleryLink) {
-        throw new Error(
-          `Item gallery link not found for the following component: \u201C${componentName}\u201D`
-        );
-      }
-      const isSearchable = getPropertyValueByLabel(
-        componentProperty.properties,
-        "is-searchable"
-      ) === "Yes";
-      properties.galleryId = galleryLink.uuid;
-      properties.isSearchable = isSearchable;
-      break;
-    }
     case "n-columns": {
       const subElements = elementResource.resource ? await parseWebpageResources(
         Array.isArray(elementResource.resource) ? elementResource.resource : [elementResource.resource],
@@ -1649,6 +1675,15 @@ async function parseWebElementProperties(componentProperty, elementResource) {
       properties.tableId = tableLink.uuid;
       break;
     }
+    case "search-bar": {
+      let variant = getPropertyValueByLabel(
+        componentProperty.properties,
+        "variant"
+      );
+      variant ??= "default";
+      properties.variant = variant;
+      break;
+    }
     case "text": {
       if (!document) {
         throw new Error(
@@ -2585,6 +2620,8 @@ export {
   parsePerson,
   parsePersons,
   parseProperties,
+  parsePropertyValue,
+  parsePropertyValues,
   parseResource,
   parseResources,
   parseSet,

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@digitalculture/ochre-sdk",
-  "version": "0.5.9",
+  "version": "0.5.11",
   "type": "module",
   "license": "MIT",
   "description": "Node.js library for working with OCHRE (Online Cultural and Historical Research Environment) data",
   "author": "Firat Ciftci <firatciftci@uchicago.edu> (https://digitalculture.uchicago.edu)",
-  "homepage": "https://github.com/forumfordigitalculture/ochre-sdk",
+  "homepage": "https://github.com/uchicago-digitalculture-webdev/ochre-sdk",
   "bugs": {
-    "url": "https://github.com/forumfordigitalculture/ochre-sdk/issues"
+    "url": "https://github.com/uchicago-digitalculture-webdev/ochre-sdk/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/forumfordigitalculture/ochre-sdk.git"
+    "url": "git+https://github.com/uchicago-digitalculture-webdev/ochre-sdk.git"
   },
   "keywords": [
     "ochre",