ochre-sdk 1.1.0 → 1.1.1

package/README.md

@@ -84,6 +84,34 @@ title.getExactText("tur");
 title.getAvailableLanguages();
 ```
 
+Reads come in three widths. `getText` and `getRichText` resolve one entry through the language fallback, `getExactText` and `getExactRichText` skip the fallback, and `getEntries`, `getTexts` and `getExactTexts` return every entry when OCHRE carried more than one for a language.
+
+Two questions look alike and are not the same. `isEmpty()` asks whether any language carries an entry at all. `hasContent()` asks whether any entry in any language holds text that is not whitespace, which is what a caller deciding whether to render something wants, because OCHRE does serve fields holding a single blank entry.
+
+```ts
+title.isEmpty();
+title.hasContent();
+title.hasLanguage("tur");
+title.hasAliases();
+
+title.getAvailableLanguages(); // languages that carry content
+title.getSupportedLanguages(); // languages the string was built to hold
+```
+
+Writes return a new string and never mutate the original.
+
+```ts
+title.with("tur", "Başlık");
+title.with("tur", "another entry", { shouldAppend: true });
+title.without("tur");
+title.withAliases(["ABC"]);
+
+title.mapText((text) => text.trim());
+title.filterEntries((entry) => entry.isPrimary);
+```
+
+`mapText` runs against plain text and rebuilds each entry's rich text from the result, so a transform cannot corrupt the markup OCHRE wrote. A transform that needs to keep or rewrite markup returns `{ text, richText }` instead of a string.
+
 For reusable language tuples, use `defineLanguages` to keep runtime validation
 and literal TypeScript inference together.
 
@@ -177,8 +205,9 @@ types, query types, property getters, and small data helpers:
 - `Item`, `SetItem`, `ItemLink`, `Website`, `WebElementOf`,
   `WebElementComponentOf`, `WebBlockByLayout`, `Query`, and related types.
 - `getProperty`, `getPropertyValues`, `getPropertyValue`,
-  `getUniqueProperties`, `getUniquePropertyVariableLabels`, and
-  `isPropertyMatchingFilter` for reading properties off a parsed item.
+  `getUniqueProperties`, `getUniquePropertyVariableLabels`,
+  `isPropertyMatchingFilter`, and `getLeafPropertyValues` for reading
+  properties off a parsed item.
 - `flattenItemProperties` and `DEFAULT_PAGE_SIZE` for common collection UI
   workflows.
 

package/dist/getters.d.mts

@@ -53,6 +53,17 @@ export type PropertySelector<T extends LanguageCodes = LanguageCodes> = {
  * @returns The normalized label
  */
 export declare function normalizePropertyVariableLabel(value: string): string;
+/**
+ * Keep only the leaf values from an array of property values
+ *
+ * OCHRE property values form a hierarchy, and a value with children is usually
+ * a grouping rather than something to show. This asks that of a values array
+ * the caller already holds; the same filter is available on the lookups
+ * through `limitToLeafPropertyValues`.
+ * @param propertyValues - The values to filter
+ * @returns The values that have no children
+ */
+export declare function getLeafPropertyValues<T extends LanguageCodes = LanguageCodes>(propertyValues: ReadonlyArray<PropertyValueContent<T>>): Array<PropertyValueContent<T>>;
 /**
  * Find the property a selector names
  *

package/dist/getters.mjs

@@ -88,6 +88,16 @@ function findProperty(properties, isMatch, shouldIncludeNestedProperties) {
 	}
 	return null;
 }
+/**
+* Keep only the leaf values from an array of property values
+*
+* OCHRE property values form a hierarchy, and a value with children is usually
+* a grouping rather than something to show. This asks that of a values array
+* the caller already holds; the same filter is available on the lookups
+* through `limitToLeafPropertyValues`.
+* @param propertyValues - The values to filter
+* @returns The values that have no children
+*/
 function getLeafPropertyValues(propertyValues) {
 	const leafPropertyValues = [];
 	for (const value of propertyValues) if (value.hierarchy.isLeaf) leafPropertyValues.push(value);
@@ -224,4 +234,4 @@ function isPropertyMatchingFilter(property, filter, options = DEFAULT_OPTIONS) {
 	return false;
 }
 //#endregion
-export { getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel };
+export { getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { MultilingualOptions, MultilingualString, MultilingualStringEntries, MultilingualStringEntry, MultilingualStringInput, MultilingualStringJSON, MultilingualStringObject, MultilingualStringText } from "./parsers/multilingual.mjs";
-import { ContextTree, ContextTreeFilterLevel, ContextTreeFilterVariant, ContextTreeLevel, ContextTreeLevelItem, ProtectedWebsite, ResponsiveStyles, Scope, Style, StylesheetItem, WebAccordionItem, WebBlock, WebBlockByLayout, WebBlockItem, WebBlockLayout, WebElement, WebElementComponent, WebElementComponentName, WebElementComponentOf, WebElementOf, WebIiifViewer, WebImage, WebLoadingVariant, WebOptions, WebSectionDisplay, WebSectionVariant, WebSidebar, WebTitle, Webpage, Website, WebsiteMetadata, WebsitePrivacy, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteSegment, WebsiteType } from "./types/website.mjs";
-import { BaseItem, BaseItemLink, BelongsTo, Bibliography, BibliographyEntryInfo, BibliographyItemLink, BibliographySourceDocument, Concept, ConceptItemLink, ContainedItemCategory, ContainedItemCategoryFromOption, ContainedItemCategoryOption, Context, ContextItem, ContextItemCategory, ContextNode, Coordinates, CoordinatesSource, DictionaryUnitItemLink, Event, Gallery, Heading, HeadingItemCategory, Identification, Image, ImageMap, ImageMapArea, Interpretation, Item, ItemCategory, ItemCategoryFromOption, ItemCategoryOption, ItemCategoryWithEmbeddedItems, ItemContainerCategory, ItemLink, ItemLinkCategory, ItemLinks, ItemPayloadKind, ItemWithoutEmbeddedItems, LanguageCodes, License, Metadata, Note, Observation, OcrString, Period, PeriodItemLink, Person, PersonItemLink, Property, PropertyLike, PropertyRelation, PropertyValue, PropertyValueContent, PropertyValueDataType, PropertyValueItemLink, PropertyValueQueryItem, PropertyVariable, PropertyVariableItemLink, Query, QueryGroup, QueryLeaf, QueryablePropertyValueDataType, Resource, ResourceItemLink, Section, Set, SetAttributeValueQueryItem, SetBibliography, SetConcept, SetItem, SetItemCategory, SetItemLink, SetItemProperty, SetItemSimplifiedProperty, SetItemsSort, SetItemsSortDirection, SetPeriod, SetResource, SetSpatialUnit, SetTree, SimplifiedProperty, SpatialUnit, SpatialUnitItemLink, Text, TextItemLink, Tree, TreeItemCategory, TreeItemLink } from "./types/index.mjs";
+import { AccordionWebBlock, ContextTree, ContextTreeFilterLevel, ContextTreeFilterVariant, ContextTreeLevel, ContextTreeLevelItem, ProtectedWebsite, ResponsiveStyles, Scope, Style, StylesheetCategory, StylesheetItem, WebAccordionItem, WebBlock, WebBlockByLayout, WebBlockItem, WebBlockLayout, WebElement, WebElementComponent, WebElementComponentName, WebElementComponentOf, WebElementOf, WebIiifViewer, WebImage, WebLoadingVariant, WebOptions, WebSectionDisplay, WebSectionVariant, WebSidebar, WebTitle, Webpage, Website, WebsiteMetadata, WebsitePrivacy, WebsitePropertyQuery, WebsitePropertyQueryNode, WebsiteSegment, WebsiteType } from "./types/website.mjs";
+import { AnyBibliography, AnyConcept, AnyItem, AnyPeriod, AnyPerson, AnyPropertyValue, AnyPropertyVariable, AnyResource, AnySet, AnySpatialUnit, AnyText, AnyTree, BaseItem, BaseItemLink, BelongsTo, Bibliography, BibliographyEntryInfo, BibliographyItemLink, BibliographySourceDocument, Concept, ConceptItemLink, ContainedItemCategory, ContainedItemCategoryFromOption, ContainedItemCategoryOption, Context, ContextItem, ContextItemCategory, ContextNode, Coordinates, CoordinatesSource, DictionaryUnitItemLink, EmbeddedBibliography, EmbeddedConcept, EmbeddedItem, EmbeddedPeriod, EmbeddedPerson, EmbeddedPropertyValue, EmbeddedPropertyVariable, EmbeddedResource, EmbeddedSet, EmbeddedSpatialUnit, EmbeddedText, EmbeddedTree, Event, Gallery, Heading, HeadingItemCategory, Identification, Image, ImageMap, ImageMapArea, Interpretation, Item, ItemCategory, ItemCategoryFromOption, ItemCategoryOption, ItemCategoryWithEmbeddedItems, ItemContainerCategory, ItemLink, ItemLinkCategory, ItemLinks, ItemPayloadKind, ItemProperty, ItemWithoutEmbeddedItems, LanguageCodes, License, Metadata, Note, Observation, OcrString, Period, PeriodItemLink, Person, PersonItemLink, Property, PropertyLike, PropertyRelation, PropertyValue, PropertyValueContent, PropertyValueDataType, PropertyValueItemLink, PropertyValueQueryItem, PropertyVariable, PropertyVariableItemLink, Query, QueryGroup, QueryLeaf, QueryablePropertyValueDataType, RecursiveItemCategory, Resource, ResourceItemLink, Section, Set, SetAttributeValueQueryItem, SetBibliography, SetConcept, SetItem, SetItemCategory, SetItemLink, SetItemProperty, SetItemSimplifiedProperty, SetItemsSort, SetItemsSortDirection, SetPeriod, SetResource, SetSpatialUnit, SetTree, SimplifiedProperty, SpatialUnit, SpatialUnitItemLink, Text, TextItemLink, TopLevelItem, Tree, TreeItemCategory, TreeItemLink } from "./types/index.mjs";
 import { DEFAULT_PAGE_SIZE } from "./constants.mjs";
 import { fetchGallery } from "./fetchers/gallery.mjs";
 import { fetchItemChildren } from "./fetchers/item-children.mjs";
@@ -11,7 +11,7 @@ import { fetchSetItems } from "./fetchers/set/items.mjs";
 import { fetchSetPropertyValues } from "./fetchers/set/property-values.mjs";
 import { fetchWebsiteMetadata } from "./fetchers/website-metadata.mjs";
 import { fetchWebsite } from "./fetchers/website.mjs";
-import { PropertyOptions, PropertySelector, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel } from "./getters.mjs";
+import { PropertyOptions, PropertySelector, getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel } from "./getters.mjs";
 import { flattenItemProperties } from "./helpers.mjs";
 import { defineLanguages } from "./parsers/languages.mjs";
-export { type BaseItem, type BaseItemLink, type BelongsTo, type Bibliography, type BibliographyEntryInfo, type BibliographyItemLink, type BibliographySourceDocument, type Concept, type ConceptItemLink, type ContainedItemCategory, type ContainedItemCategoryFromOption, type ContainedItemCategoryOption, type Context, type ContextItem, type ContextItemCategory, type ContextNode, type ContextTree, type ContextTreeFilterLevel, type ContextTreeFilterVariant, type ContextTreeLevel, type ContextTreeLevelItem, type Coordinates, type CoordinatesSource, DEFAULT_PAGE_SIZE, type DictionaryUnitItemLink, type Event, type Gallery, type Heading, type HeadingItemCategory, type Identification, type Image, type ImageMap, type ImageMapArea, type Interpretation, type Item, type ItemCategory, type ItemCategoryFromOption, type ItemCategoryOption, type ItemCategoryWithEmbeddedItems, type ItemContainerCategory, type ItemLink, type ItemLinkCategory, type ItemLinks, type ItemPayloadKind, type ItemWithoutEmbeddedItems, type LanguageCodes, type License, type Metadata, type MultilingualOptions, MultilingualString, type MultilingualStringEntries, type MultilingualStringEntry, type MultilingualStringInput, type MultilingualStringJSON, type MultilingualStringObject, type MultilingualStringText, type Note, type Observation, type OcrString, type Period, type PeriodItemLink, type Person, type PersonItemLink, type Property, type PropertyLike, type PropertyOptions, type PropertyRelation, type PropertySelector, type PropertyValue, type PropertyValueContent, type PropertyValueDataType, type PropertyValueItemLink, type PropertyValueQueryItem, type PropertyVariable, type PropertyVariableItemLink, type ProtectedWebsite, type Query, type QueryGroup, type QueryLeaf, type QueryablePropertyValueDataType, type Resource, type ResourceItemLink, type ResponsiveStyles, type Scope, type Section, type Set, type SetAttributeValueQueryItem, type SetBibliography, type SetConcept, type SetItem, type SetItemCategory, type SetItemLink, type SetItemProperty, type SetItemSimplifiedProperty, type SetItemsSort, type SetItemsSortDirection, type SetPeriod, type SetResource, type SetSpatialUnit, type SetTree, type SimplifiedProperty, type SpatialUnit, type SpatialUnitItemLink, type Style, type StylesheetItem, type Text, type TextItemLink, type Tree, type TreeItemCategory, type TreeItemLink, type WebAccordionItem, type WebBlock, type WebBlockByLayout, type WebBlockItem, type WebBlockLayout, type WebElement, type WebElementComponent, type WebElementComponentName, type WebElementComponentOf, type WebElementOf, type WebIiifViewer, type WebImage, type WebLoadingVariant, type WebOptions, type WebSectionDisplay, type WebSectionVariant, type WebSidebar, type WebTitle, type Webpage, type Website, type WebsiteMetadata, type WebsitePrivacy, type WebsitePropertyQuery, type WebsitePropertyQueryNode, type WebsiteSegment, type WebsiteType, defineLanguages, fetchGallery, fetchItem, fetchItemChildren, fetchItemLinks, fetchItemOcrData, fetchSetItems, fetchSetPropertyValues, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel };
+export { type AccordionWebBlock, type AnyBibliography, type AnyConcept, type AnyItem, type AnyPeriod, type AnyPerson, type AnyPropertyValue, type AnyPropertyVariable, type AnyResource, type AnySet, type AnySpatialUnit, type AnyText, type AnyTree, type BaseItem, type BaseItemLink, type BelongsTo, type Bibliography, type BibliographyEntryInfo, type BibliographyItemLink, type BibliographySourceDocument, type Concept, type ConceptItemLink, type ContainedItemCategory, type ContainedItemCategoryFromOption, type ContainedItemCategoryOption, type Context, type ContextItem, type ContextItemCategory, type ContextNode, type ContextTree, type ContextTreeFilterLevel, type ContextTreeFilterVariant, type ContextTreeLevel, type ContextTreeLevelItem, type Coordinates, type CoordinatesSource, DEFAULT_PAGE_SIZE, type DictionaryUnitItemLink, type EmbeddedBibliography, type EmbeddedConcept, type EmbeddedItem, type EmbeddedPeriod, type EmbeddedPerson, type EmbeddedPropertyValue, type EmbeddedPropertyVariable, type EmbeddedResource, type EmbeddedSet, type EmbeddedSpatialUnit, type EmbeddedText, type EmbeddedTree, type Event, type Gallery, type Heading, type HeadingItemCategory, type Identification, type Image, type ImageMap, type ImageMapArea, type Interpretation, type Item, type ItemCategory, type ItemCategoryFromOption, type ItemCategoryOption, type ItemCategoryWithEmbeddedItems, type ItemContainerCategory, type ItemLink, type ItemLinkCategory, type ItemLinks, type ItemPayloadKind, type ItemProperty, type ItemWithoutEmbeddedItems, type LanguageCodes, type License, type Metadata, type MultilingualOptions, MultilingualString, type MultilingualStringEntries, type MultilingualStringEntry, type MultilingualStringInput, type MultilingualStringJSON, type MultilingualStringObject, type MultilingualStringText, type Note, type Observation, type OcrString, type Period, type PeriodItemLink, type Person, type PersonItemLink, type Property, type PropertyLike, type PropertyOptions, type PropertyRelation, type PropertySelector, type PropertyValue, type PropertyValueContent, type PropertyValueDataType, type PropertyValueItemLink, type PropertyValueQueryItem, type PropertyVariable, type PropertyVariableItemLink, type ProtectedWebsite, type Query, type QueryGroup, type QueryLeaf, type QueryablePropertyValueDataType, type RecursiveItemCategory, type Resource, type ResourceItemLink, type ResponsiveStyles, type Scope, type Section, type Set, type SetAttributeValueQueryItem, type SetBibliography, type SetConcept, type SetItem, type SetItemCategory, type SetItemLink, type SetItemProperty, type SetItemSimplifiedProperty, type SetItemsSort, type SetItemsSortDirection, type SetPeriod, type SetResource, type SetSpatialUnit, type SetTree, type SimplifiedProperty, type SpatialUnit, type SpatialUnitItemLink, type Style, type StylesheetCategory, type StylesheetItem, type Text, type TextItemLink, type TopLevelItem, type Tree, type TreeItemCategory, type TreeItemLink, type WebAccordionItem, type WebBlock, type WebBlockByLayout, type WebBlockItem, type WebBlockLayout, type WebElement, type WebElementComponent, type WebElementComponentName, type WebElementComponentOf, type WebElementOf, type WebIiifViewer, type WebImage, type WebLoadingVariant, type WebOptions, type WebSectionDisplay, type WebSectionVariant, type WebSidebar, type WebTitle, type Webpage, type Website, type WebsiteMetadata, type WebsitePrivacy, type WebsitePropertyQuery, type WebsitePropertyQueryNode, type WebsiteSegment, type WebsiteType, defineLanguages, fetchGallery, fetchItem, fetchItemChildren, fetchItemLinks, fetchItemOcrData, fetchSetItems, fetchSetPropertyValues, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { DEFAULT_PAGE_SIZE } from "./constants.mjs";
-import { getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel } from "./getters.mjs";
+import { getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel } from "./getters.mjs";
 import { flattenItemProperties } from "./helpers.mjs";
 import { MultilingualString } from "./parsers/multilingual.mjs";
 import { defineLanguages } from "./parsers/languages.mjs";
@@ -12,4 +12,4 @@ import { fetchSetItems } from "./fetchers/set/items.mjs";
 import { fetchSetPropertyValues } from "./fetchers/set/property-values.mjs";
 import { fetchWebsiteMetadata } from "./fetchers/website-metadata.mjs";
 import { fetchWebsite } from "./fetchers/website.mjs";
-export { DEFAULT_PAGE_SIZE, MultilingualString, defineLanguages, fetchGallery, fetchItem, fetchItemChildren, fetchItemLinks, fetchItemOcrData, fetchSetItems, fetchSetPropertyValues, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel };
+export { DEFAULT_PAGE_SIZE, MultilingualString, defineLanguages, fetchGallery, fetchItem, fetchItemChildren, fetchItemLinks, fetchItemOcrData, fetchSetItems, fetchSetPropertyValues, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel };

package/dist/parsers/multilingual.d.mts

@@ -126,6 +126,29 @@ export declare class MultilingualString<T extends ReadonlyArray<string> = Readon
    * Get every entry for a specific language, with no fallback
    */
   getExactEntries(language: T[number]): Array<MultilingualStringEntry>;
+  /**
+   * Get every entry for a language, falling back when it has none
+   *
+   * The multi-entry counterpart of {@link MultilingualString.getText}: OCHRE
+   * can carry several entries for one language, and this returns all of them
+   * rather than only the primary. Each entry carries both `text` and
+   * `richText`, so a caller rendering a rich field reads them from here.
+   * @param language - The language to read, or undefined for the default
+   * @returns The entries, or an empty array when no language has any
+   */
+  getEntries(language?: T[number]): Array<MultilingualStringEntry>;
+  /**
+   * Get the text of every entry for a language, falling back when it has none
+   * @param language - The language to read, or undefined for the default
+   * @returns The texts, or an empty array when no language has any
+   */
+  getTexts(language?: T[number]): Array<string>;
+  /**
+   * Get the text of every entry for a language, with no fallback
+   * @param language - The language to read
+   * @returns The texts, or an empty array when that language has none
+   */
+  getExactTexts(language: T[number]): Array<string>;
   /**
    * Get the alias values OCHRE carries as `zxx` content
    */
@@ -138,6 +161,46 @@ export declare class MultilingualString<T extends ReadonlyArray<string> = Readon
    * Get the language reads fall back to before trying the rest
    */
   getDefaultLanguage(): T[number];
+  /**
+   * Get every language this string was built to hold
+   *
+   * The configured language list, which is not the same question as
+   * {@link MultilingualString.getAvailableLanguages}: that one answers which
+   * languages actually carry content, and is a subset of this.
+   * @returns The supported languages
+   */
+  getSupportedLanguages(): Array<T[number]>;
+  /**
+   * Whether any language carries an entry
+   *
+   * Answers the structural question. A language whose only entry is blank
+   * still counts here; {@link MultilingualString.hasContent} is the question
+   * about text. Aliases are not entries, so a string carrying only aliases is
+   * empty by this measure and {@link MultilingualString.hasAliases} is true.
+   * @returns True when no language carries an entry
+   */
+  isEmpty(): boolean;
+  /**
+   * Whether any entry in any language carries text that is not whitespace
+   *
+   * Deliberately not the negation of {@link MultilingualString.isEmpty}, which
+   * only asks whether entries exist. OCHRE does serve fields holding a single
+   * whitespace entry, so a caller deciding whether to render something wants
+   * this one, and it looks at every entry rather than only the primary.
+   * @returns True when some entry has non-whitespace text
+   */
+  hasContent(): boolean;
+  /**
+   * Whether a specific language carries an entry, with no fallback
+   * @param language - The language to test
+   * @returns True when that language carries at least one entry
+   */
+  hasLanguage(language: T[number]): boolean;
+  /**
+   * Whether OCHRE carried any `zxx` alias values for this string
+   * @returns True when there is at least one alias
+   */
+  hasAliases(): boolean;
   /**
    * Set the text for a language, or append another entry to it
    * @param language - The language to write
@@ -158,6 +221,44 @@ export declare class MultilingualString<T extends ReadonlyArray<string> = Readon
    * @returns A new multilingual string
    */
   without(language: T[number]): MultilingualString<T>;
+  /**
+   * Replace the alias values
+   *
+   * Aliases are the `zxx` content OCHRE carries alongside a field's languages,
+   * so they are set as a whole rather than per language. Empty strings are
+   * dropped, matching how they are read from a payload.
+   * @param aliases - The aliases to carry
+   * @returns A new multilingual string
+   */
+  withAliases(aliases: ReadonlyArray<string>): MultilingualString<T>;
+  /**
+   * Transform the text of every entry in every language
+   *
+   * Replaces the old `map`, which corrupted rich text: it wrote the
+   * transformed plain text and left the entry's `richText` to be re-derived,
+   * so a transform such as uppercasing turned `<InternalLink uuid="abc">` into
+   * markup OCHRE never wrote. The transform here runs against plain text only,
+   * and the entry's rich text is rebuilt from the result, so the two can never
+   * disagree.
+   *
+   * A transform that needs to keep or rewrite markup returns
+   * `{ text, richText }` instead of a string, and both are used verbatim.
+   * @param transform - Produces the new text for one entry
+   * @returns A new multilingual string
+   */
+  mapText(transform: (text: string, language: T[number]) => MultilingualStringInput): MultilingualString<T>;
+  /**
+   * Keep only the entries a predicate accepts
+   *
+   * The callback receives the whole entry rather than just its text, so it
+   * can also test `richText` and `isPrimary`. Dropping every entry of a
+   * language removes that language, and when that was the default the default
+   * moves to the first language that still has content, so reads keep
+   * resolving.
+   * @param shouldKeep - Whether to keep one entry
+   * @returns A new multilingual string
+   */
+  filterEntries(shouldKeep: (entry: MultilingualStringEntry, language: T[number]) => boolean): MultilingualString<T>;
   /**
    * Get the string representation, using the default language
    */

package/dist/parsers/multilingual.mjs

@@ -222,6 +222,35 @@ var MultilingualString = class MultilingualString {
 		return Array.from(this.resolveEntries(language, true), (entry) => ({ ...entry }));
 	}
 	/**
+	* Get every entry for a language, falling back when it has none
+	*
+	* The multi-entry counterpart of {@link MultilingualString.getText}: OCHRE
+	* can carry several entries for one language, and this returns all of them
+	* rather than only the primary. Each entry carries both `text` and
+	* `richText`, so a caller rendering a rich field reads them from here.
+	* @param language - The language to read, or undefined for the default
+	* @returns The entries, or an empty array when no language has any
+	*/
+	getEntries(language) {
+		return Array.from(this.resolveEntries(language, false), (entry) => ({ ...entry }));
+	}
+	/**
+	* Get the text of every entry for a language, falling back when it has none
+	* @param language - The language to read, or undefined for the default
+	* @returns The texts, or an empty array when no language has any
+	*/
+	getTexts(language) {
+		return Array.from(this.resolveEntries(language, false), (entry) => entry.text);
+	}
+	/**
+	* Get the text of every entry for a language, with no fallback
+	* @param language - The language to read
+	* @returns The texts, or an empty array when that language has none
+	*/
+	getExactTexts(language) {
+		return Array.from(this.resolveEntries(language, true), (entry) => entry.text);
+	}
+	/**
 	* Get the alias values OCHRE carries as `zxx` content
 	*/
 	getAliases() {
@@ -240,6 +269,60 @@ var MultilingualString = class MultilingualString {
 		return this._options.defaultLanguage;
 	}
 	/**
+	* Get every language this string was built to hold
+	*
+	* The configured language list, which is not the same question as
+	* {@link MultilingualString.getAvailableLanguages}: that one answers which
+	* languages actually carry content, and is a subset of this.
+	* @returns The supported languages
+	*/
+	getSupportedLanguages() {
+		return [...this._options.availableLanguages];
+	}
+	/**
+	* Whether any language carries an entry
+	*
+	* Answers the structural question. A language whose only entry is blank
+	* still counts here; {@link MultilingualString.hasContent} is the question
+	* about text. Aliases are not entries, so a string carrying only aliases is
+	* empty by this measure and {@link MultilingualString.hasAliases} is true.
+	* @returns True when no language carries an entry
+	*/
+	isEmpty() {
+		return this._availableLanguages.length === 0;
+	}
+	/**
+	* Whether any entry in any language carries text that is not whitespace
+	*
+	* Deliberately not the negation of {@link MultilingualString.isEmpty}, which
+	* only asks whether entries exist. OCHRE does serve fields holding a single
+	* whitespace entry, so a caller deciding whether to render something wants
+	* this one, and it looks at every entry rather than only the primary.
+	* @returns True when some entry has non-whitespace text
+	*/
+	hasContent() {
+		for (const language of this._availableLanguages) {
+			const entries = this._content[language] ?? [];
+			for (const entry of entries) if (entry.text.trim() !== "") return true;
+		}
+		return false;
+	}
+	/**
+	* Whether a specific language carries an entry, with no fallback
+	* @param language - The language to test
+	* @returns True when that language carries at least one entry
+	*/
+	hasLanguage(language) {
+		return (this._content[language]?.length ?? 0) > 0;
+	}
+	/**
+	* Whether OCHRE carried any `zxx` alias values for this string
+	* @returns True when there is at least one alias
+	*/
+	hasAliases() {
+		return this._aliases.length > 0;
+	}
+	/**
 	* Set the text for a language, or append another entry to it
 	* @param language - The language to write
 	* @param text - The text to write
@@ -274,6 +357,72 @@ var MultilingualString = class MultilingualString {
 		}, newAvailableLanguages);
 	}
 	/**
+	* Replace the alias values
+	*
+	* Aliases are the `zxx` content OCHRE carries alongside a field's languages,
+	* so they are set as a whole rather than per language. Empty strings are
+	* dropped, matching how they are read from a payload.
+	* @param aliases - The aliases to carry
+	* @returns A new multilingual string
+	*/
+	withAliases(aliases) {
+		return MultilingualString.fromNormalized(cloneContent(this._content), {
+			...this._options,
+			aliases: normalizeAliases(aliases)
+		}, this._availableLanguages);
+	}
+	/**
+	* Transform the text of every entry in every language
+	*
+	* Replaces the old `map`, which corrupted rich text: it wrote the
+	* transformed plain text and left the entry's `richText` to be re-derived,
+	* so a transform such as uppercasing turned `<InternalLink uuid="abc">` into
+	* markup OCHRE never wrote. The transform here runs against plain text only,
+	* and the entry's rich text is rebuilt from the result, so the two can never
+	* disagree.
+	*
+	* A transform that needs to keep or rewrite markup returns
+	* `{ text, richText }` instead of a string, and both are used verbatim.
+	* @param transform - Produces the new text for one entry
+	* @returns A new multilingual string
+	*/
+	mapText(transform) {
+		const newContent = {};
+		for (const language of this._availableLanguages) {
+			const currentEntries = this._content[language] ?? [];
+			newContent[language] = normalizePrimary(Array.from(currentEntries, (entry) => ({
+				...normalizeInputText(transform(entry.text, language)),
+				isPrimary: entry.isPrimary
+			})));
+		}
+		return MultilingualString.fromNormalized(newContent, this._options, this._availableLanguages);
+	}
+	/**
+	* Keep only the entries a predicate accepts
+	*
+	* The callback receives the whole entry rather than just its text, so it
+	* can also test `richText` and `isPrimary`. Dropping every entry of a
+	* language removes that language, and when that was the default the default
+	* moves to the first language that still has content, so reads keep
+	* resolving.
+	* @param shouldKeep - Whether to keep one entry
+	* @returns A new multilingual string
+	*/
+	filterEntries(shouldKeep) {
+		const newContent = {};
+		for (const language of this._availableLanguages) {
+			const currentEntries = this._content[language] ?? [];
+			const entries = [];
+			for (const entry of currentEntries) if (shouldKeep({ ...entry }, language)) entries.push({ ...entry });
+			newContent[language] = normalizePrimary(entries);
+		}
+		const newAvailableLanguages = getLanguagesWithEntries(newContent, this._options.availableLanguages);
+		return MultilingualString.fromNormalized(newContent, {
+			...this._options,
+			defaultLanguage: newAvailableLanguages.includes(this._options.defaultLanguage) ? this._options.defaultLanguage : resolveDefaultLanguageOption(newAvailableLanguages, this._options.availableLanguages)
+		}, newAvailableLanguages);
+	}
+	/**
 	* Get the string representation, using the default language
 	*/
 	toString() {

package/dist/types/index.d.mts

@@ -888,4 +888,34 @@ export type QueryGroup = {
  * Represents a query for Set items
  */
 export type Query = QueryLeaf | QueryGroup;
+export type AnyBibliography<T extends LanguageCodes = LanguageCodes> = Bibliography<T, ItemPayloadKind>;
+export type AnyConcept<T extends LanguageCodes = LanguageCodes> = Concept<T, ItemPayloadKind>;
+export type AnyItem<U extends ItemCategory = ItemCategory, V extends ContainedItemCategory<U> = ContainedItemCategory<U>, T extends LanguageCodes = LanguageCodes> = Item<U, V, T, ItemPayloadKind>;
+export type AnyPeriod<T extends LanguageCodes = LanguageCodes> = Period<T, ItemPayloadKind>;
+export type AnyPerson<T extends LanguageCodes = LanguageCodes> = Person<T, ItemPayloadKind>;
+export type AnyPropertyValue<T extends LanguageCodes = LanguageCodes> = PropertyValue<T, ItemPayloadKind>;
+export type AnyPropertyVariable<T extends LanguageCodes = LanguageCodes> = PropertyVariable<T, ItemPayloadKind>;
+export type AnyResource<T extends LanguageCodes = LanguageCodes> = Resource<T, ItemPayloadKind>;
+export type AnySet<U extends SetItemCategory = SetItemCategory, T extends LanguageCodes = LanguageCodes> = Set<U, T, ItemPayloadKind>;
+export type AnySpatialUnit<T extends LanguageCodes = LanguageCodes> = SpatialUnit<T, ItemPayloadKind>;
+export type AnyText<T extends LanguageCodes = LanguageCodes> = Text<T, ItemPayloadKind>;
+export type AnyTree<U extends TreeItemCategory = TreeItemCategory, T extends LanguageCodes = LanguageCodes> = Tree<U, T, ItemPayloadKind>;
+export type EmbeddedBibliography<T extends LanguageCodes = LanguageCodes> = Bibliography<T, "embedded">;
+export type EmbeddedConcept<T extends LanguageCodes = LanguageCodes> = Concept<T, "embedded">;
+export type EmbeddedItem<U extends ItemCategory = ItemCategory, V extends ContainedItemCategory<U> = ContainedItemCategory<U>, T extends LanguageCodes = LanguageCodes> = Item<U, V, T, "embedded">;
+export type EmbeddedPeriod<T extends LanguageCodes = LanguageCodes> = Period<T, "embedded">;
+export type EmbeddedPerson<T extends LanguageCodes = LanguageCodes> = Person<T, "embedded">;
+export type EmbeddedPropertyValue<T extends LanguageCodes = LanguageCodes> = PropertyValue<T, "embedded">;
+export type EmbeddedPropertyVariable<T extends LanguageCodes = LanguageCodes> = PropertyVariable<T, "embedded">;
+export type EmbeddedResource<T extends LanguageCodes = LanguageCodes> = Resource<T, "embedded">;
+export type EmbeddedSet<U extends SetItemCategory = SetItemCategory, T extends LanguageCodes = LanguageCodes> = Set<U, T, "embedded">;
+export type EmbeddedSpatialUnit<T extends LanguageCodes = LanguageCodes> = SpatialUnit<T, "embedded">;
+export type EmbeddedText<T extends LanguageCodes = LanguageCodes> = Text<T, "embedded">;
+export type EmbeddedTree<U extends TreeItemCategory = TreeItemCategory, T extends LanguageCodes = LanguageCodes> = Tree<U, T, "embedded">;
+export type ItemProperty<T extends LanguageCodes = LanguageCodes> = Property<T> | SetItemProperty<T>;
+/**
+ * The category of items that expose recursive subitem structures.
+ */
+export type RecursiveItemCategory = Exclude<ItemCategory, "tree" | "person" | "propertyVariable" | "propertyValue" | "set">;
+export type TopLevelItem<U extends ItemCategory = ItemCategory, V extends ContainedItemCategory<U> = ContainedItemCategory<U>, T extends LanguageCodes = LanguageCodes> = Item<U, V, T, "topLevel">;
 //#endregion

package/dist/types/website.d.mts

@@ -1,6 +1,6 @@
 import { MultilingualString } from "../parsers/multilingual.mjs";
 import { Prettify } from "./utilities.mjs";
-import { Bibliography, Identification, LanguageCodes, License, Metadata, Person, QueryablePropertyValueDataType } from "./index.mjs";
+import { Bibliography, Identification, ItemCategory, LanguageCodes, License, Metadata, Person, QueryablePropertyValueDataType } from "./index.mjs";
 //#region src/types/website.d.ts
 /**
  * Represents a context tree level item with a variable and value
@@ -552,4 +552,9 @@ export type ProtectedWebsite<T extends LanguageCodes = LanguageCodes> = {
     privacy: "password" | "credentials-ochre";
   };
 };
+export type AccordionWebBlock<T extends LanguageCodes = LanguageCodes> = WebBlock<T, "accordion">;
+/**
+ * Represents a stylesheet item with its UUID and category
+ */
+export type StylesheetCategory = Extract<ItemCategory, "propertyVariable" | "propertyValue">;
 //#endregion

package/dist/xml/types.d.mts

@@ -1,5 +1,5 @@
 declare namespace types_d_exports {
-  export { XMLBaseItem, XMLBibliography, XMLConcept, XMLContent, XMLContext, XMLContextGroup, XMLContextItem, XMLContextValue, XMLCoordinate, XMLCoordinates, XMLCoordinatesSource, XMLData, XMLDataItem, XMLDictionaryUnit, XMLEmptyContext, XMLEvent, XMLGallery, XMLGalleryData, XMLHeading, XMLIdentification, XMLImage, XMLImageMap, XMLImageMapArea, XMLInterpretation, XMLItemCategory, XMLItemLinks, XMLItemLinksData, XMLLicense, XMLLink, XMLLinkedBaseItem, XMLLinkedBibliography, XMLLinkedConcept, XMLLinkedPeriod, XMLLinkedPerson, XMLLinkedPropertyValue, XMLLinkedPropertyVariable, XMLLinkedResource, XMLLinkedSet, XMLLinkedSpatialUnit, XMLLinkedText, XMLLinkedTree, XMLMetadata, XMLNote, XMLObservation, XMLPeriod, XMLPerson, XMLProperty, XMLPropertyRelation, XMLPropertyValue, XMLPropertyVariable, XMLRecursiveItemCategory, XMLResource, XMLRichTextEnvelope, XMLSection, XMLSet, XMLSetItems, XMLSetItemsData, XMLSimplifiedProperty, XMLSpatialUnit, XMLString, XMLText, XMLTree, XMLWebsiteContext, XMLWebsiteContextItem, XMLWebsiteContextLevel, XMLWebsiteData, XMLWebsiteFilterContext, XMLWebsiteFilterContextItem, XMLWebsiteOptions, XMLWebsiteProperties, XMLWebsiteResource, XMLWebsiteResourceGroup, XMLWebsiteResourceItem, XMLWebsiteScope, XMLWebsiteSegment, XMLWebsiteStyle, XMLWebsiteTree };
+  export { XMLBaseItem, XMLBibliography, XMLConcept, XMLContent, XMLContext, XMLContextGroup, XMLContextItem, XMLContextValue, XMLCoordinate, XMLCoordinates, XMLCoordinatesSource, XMLData, XMLDataItem, XMLDictionaryUnit, XMLEmptyContext, XMLEvent, XMLGallery, XMLGalleryData, XMLHeading, XMLHeadingItemCategory, XMLIdentification, XMLImage, XMLImageMap, XMLImageMapArea, XMLInterpretation, XMLItemCategory, XMLItemLinks, XMLItemLinksData, XMLLicense, XMLLink, XMLLinkedBaseItem, XMLLinkedBibliography, XMLLinkedConcept, XMLLinkedPeriod, XMLLinkedPerson, XMLLinkedPropertyValue, XMLLinkedPropertyVariable, XMLLinkedResource, XMLLinkedSet, XMLLinkedSpatialUnit, XMLLinkedText, XMLLinkedTree, XMLMetadata, XMLNote, XMLObservation, XMLPeriod, XMLPerson, XMLProperty, XMLPropertyRelation, XMLPropertyValue, XMLPropertyVariable, XMLRecursiveItemCategory, XMLResource, XMLRichTextEnvelope, XMLSection, XMLSet, XMLSetItems, XMLSetItemsData, XMLSimplifiedProperty, XMLSpatialUnit, XMLString, XMLText, XMLTree, XMLWebsiteContext, XMLWebsiteContextItem, XMLWebsiteContextLevel, XMLWebsiteData, XMLWebsiteFilterContext, XMLWebsiteFilterContextItem, XMLWebsiteOptions, XMLWebsiteProperties, XMLWebsiteResource, XMLWebsiteResourceGroup, XMLWebsiteResourceItem, XMLWebsiteScope, XMLWebsiteSegment, XMLWebsiteStyle, XMLWebsiteTree };
 }
 export type XMLItemCategory = "tree" | "bibliography" | "spatialUnit" | "concept" | "period" | "person" | "propertyVariable" | "variable" | "propertyValue" | "value" | "text" | "resource" | "set";
 export type XMLRecursiveItemCategory = Exclude<XMLItemCategory, "tree" | "person" | "propertyVariable" | "propertyValue" | "set">;
@@ -901,5 +901,6 @@ export type XMLWebsiteData = {
     };
   };
 };
+export type XMLHeadingItemCategory = Exclude<XMLItemCategory, "tree" | "bibliography" | "spatialUnit" | "concept" | "period">;
 //#endregion
 export { types_d_exports };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ochre-sdk",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "type": "module",
   "license": "MIT",
   "description": "Node.js library for working with OCHRE (Online Cultural and Historical Research Environment) data",