ochre-sdk 1.3.13 → 1.3.14

package/dist/categories.d.mts

@@ -1,5 +1,4 @@
 import { ContextItemCategory, HeadingItemCategory, ItemCategory, ItemCategoryWithEmbeddedItems, ItemContainerCategory, ItemLinkCategory, TreeItemCategory } from "./types/index.mjs";
-//#region src/categories.d.ts
 /**
  * Every category an item hierarchy entry can carry, including the
  * pseudo-category OCHRE uses to group entries
@@ -245,5 +244,4 @@ export declare function isHeadingItemCategory(category: TreeItemCategory): categ
  * @returns The canonical category, or null when the name is not one
  * @internal
  */
-export declare function normalizeItemCategory(category: string | undefined): ItemCategory | null;
-//#endregion
+export declare function normalizeItemCategory(category: string | undefined): ItemCategory | null;

package/dist/categories.mjs

@@ -1,4 +1,4 @@
-//#region src/categories.ts
+// src/categories.ts
 /**
 * The one table describing the OCHRE item categories
 * @internal
@@ -255,5 +255,4 @@ function normalizeItemCategory(category) {
 	const normalizedCategory = ITEM_CATEGORY_BY_ALIAS.get(category);
 	return normalizedCategory != null && ITEM_CATEGORY_FACTS[normalizedCategory].isSetItem ? normalizedCategory : null;
 }
-//#endregion
 export { CONTEXT_CATEGORY_ALIASES, HEADING_ITEM_CATEGORIES, ITEM_CATEGORIES_WITH_EMBEDDED_ITEMS, ITEM_CATEGORY_ALIASES, ITEM_CATEGORY_BY_ALIAS, ITEM_CATEGORY_FACTS, ITEM_CONTAINER_CATEGORIES, OCHRE_COLLECTION_CATEGORIES, SET_ITEM_CATEGORIES, TREE_ITEM_CATEGORIES, isHeadingItemCategory, isItemCategoryWithEmbeddedItems, isItemContainerCategory, normalizeItemCategory };

package/dist/constants.d.mts

@@ -1,5 +1,4 @@
 import { X2jOptions } from "fast-xml-parser";
-//#region src/constants.d.ts
 export declare const XML_ARRAY_TAGS: ReadonlyArray<string>;
 export declare const XML_PARSER_OPTIONS: X2jOptions;
 export declare const DEFAULT_LANGUAGES: readonly ["eng"];
@@ -25,5 +24,4 @@ export declare const TEXT_ANNOTATION_ITEM_PAGE_VARIANT_UUID = "bf4476ab-6bc8-40d
 export declare const TEXT_ANNOTATION_ENTRY_PAGE_VARIANT_UUID = "9d52db95-a9cf-45f7-a0bf-fc9ba9f0aae0";
 export declare const TEXT_ANNOTATION_TEXT_STYLING_UUID = "3e6f86ab-df81-45ae-8257-e2867357df56";
 export declare const TEXT_ANNOTATION_TEXT_STYLING_VARIANT_UUID = "e1647bef-d801-4100-bdde-d081c422f763";
-export declare const TEXT_ANNOTATION_TEXT_STYLING_HEADING_LEVEL_UUID = "d4266f0b-3f8d-4b32-8c15-4b229c8bb11e";
-//#endregion
+export declare const TEXT_ANNOTATION_TEXT_STYLING_HEADING_LEVEL_UUID = "d4266f0b-3f8d-4b32-8c15-4b229c8bb11e";

package/dist/constants.mjs

@@ -1,4 +1,5 @@
-//#region src/constants.ts
+import { COMMON_HTML, CURRENCY, ENTITY_ACTION, EntityDecoder } from "@nodable/entities";
+// src/constants.ts
 const XML_ARRAY_TAGS = [
 	"string",
 	"content",
@@ -51,7 +52,8 @@ const XML_ARRAY_TAGS = [
 	"detailContexts",
 	"downloadContexts",
 	"labelContexts",
-	"prominentContexts"
+	"prominentContexts",
+	"option"
 ];
 const XML_PARSER_OPTIONS = {
 	alwaysCreateTextNode: true,
@@ -65,7 +67,13 @@ const XML_PARSER_OPTIONS = {
 	attributeNamePrefix: "",
 	textNodeName: "payload",
 	stopNodes: ["*.referenceFormatDiv", "*.citationFormatSpan"],
-	htmlEntities: true,
+	entityDecoder: new EntityDecoder({
+		namedEntities: {
+			...COMMON_HTML,
+			...CURRENCY
+		},
+		onInputEntity: () => ENTITY_ACTION.BLOCK
+	}),
 	isArray(tagName, _, __, isAttribute) {
 		if (isAttribute) return false;
 		return XML_ARRAY_TAGS.includes(tagName);
@@ -102,5 +110,4 @@ const TEXT_ANNOTATION_ENTRY_PAGE_VARIANT_UUID = "9d52db95-a9cf-45f7-a0bf-fc9ba9f
 const TEXT_ANNOTATION_TEXT_STYLING_UUID = "3e6f86ab-df81-45ae-8257-e2867357df56";
 const TEXT_ANNOTATION_TEXT_STYLING_VARIANT_UUID = "e1647bef-d801-4100-bdde-d081c422f763";
 const TEXT_ANNOTATION_TEXT_STYLING_HEADING_LEVEL_UUID = "d4266f0b-3f8d-4b32-8c15-4b229c8bb11e";
-//#endregion
 export { BELONGS_TO_COLLECTION_UUID, DEFAULT_LANGUAGES, DEFAULT_PAGE_SIZE, OCHRE_ENDPOINT, PERMANENT_IDENTIFICATION_URL_PREFIX, PRESENTATION_ITEM_UUID, TEXT_ANNOTATION_ENTRY_PAGE_VARIANT_UUID, TEXT_ANNOTATION_HOVER_CARD_UUID, TEXT_ANNOTATION_ITEM_PAGE_VARIANT_UUID, TEXT_ANNOTATION_TEXT_STYLING_HEADING_LEVEL_UUID, TEXT_ANNOTATION_TEXT_STYLING_UUID, TEXT_ANNOTATION_TEXT_STYLING_VARIANT_UUID, TEXT_ANNOTATION_UUID, XML_ARRAY_TAGS, XML_PARSER_OPTIONS, getOchreItemUrl };

package/dist/errors.d.mts

@@ -1,5 +1,4 @@
 import * as v from "valibot";
-//#region src/errors.d.ts
 type SchemaValidationIssue = v.BaseIssue<unknown>;
 /**
  * Render an error as a short message and a fully detailed report
@@ -20,5 +19,4 @@ export declare function getErrorOutput(error: unknown, fallbackMessage: string):
  * @internal
  */
 export declare function createSchemaValidationError(message: string, issues: ReadonlyArray<SchemaValidationIssue>): Error;
-//#endregion
 export {};

package/dist/errors.mjs

@@ -1,6 +1,6 @@
 import { isObject, readEntries } from "./reflection.mjs";
 import * as v from "valibot";
-//#region src/errors.ts
+// src/errors.ts
 /**
 * The shape a valibot issue has to have for this module to render it
 *
@@ -160,5 +160,4 @@ function createSchemaValidationError(message, issues) {
 * @returns True if the string is a valid pseudo-UUID, false otherwise
 * @internal
 */
-//#endregion
 export { createSchemaValidationError, getErrorOutput };

package/dist/fetchers/container-items.d.mts

@@ -1,7 +1,6 @@
 import { ItemCategory, Query, SetItem, SetItemsSort } from "../types/index.mjs";
 import { XMLSetItems } from "../xml/types.mjs";
 import { FetchRuntimeOptions } from "../parsers/helpers.mjs";
-//#region src/fetchers/container-items.d.ts
 /**
  * Whether a container payload carries any item of a category
  * @param items - The parsed `<items>` payload
@@ -48,5 +47,4 @@ export declare function fetchContainerItems(parameters: {
   page: number;
   pageSize: number;
   items: Array<SetItem<ItemCategory, ReadonlyArray<string>>>;
-}>;
-//#endregion
+}>;

package/dist/fetchers/container-items.mjs

@@ -4,7 +4,7 @@ import { parseSetItems } from "../parsers/index.mjs";
 import { XMLSetItemsData } from "../xml/schemas.mjs";
 import { getContentLanguage, stringLiteral } from "../xquery.mjs";
 import { compileContainerItemsQuery } from "../query.mjs";
-//#region src/fetchers/container-items.ts
+// src/fetchers/container-items.ts
 function hasArray(items) {
 	return items != null && items.length > 0;
 }
@@ -180,5 +180,4 @@ async function fetchContainerItems(parameters) {
 		items: itemsByUuid.values().toArray()
 	};
 }
-//#endregion
 export { fetchContainerItems, hasItemsCategory };

package/dist/fetchers/gallery.d.mts

@@ -1,6 +1,5 @@
 import { Gallery } from "../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-//#region src/fetchers/gallery.d.ts
 /**
  * Fetches and parses a gallery from the OCHRE API
  *
@@ -27,5 +26,4 @@ export declare function fetchGallery<const TLanguages extends ReadonlyArray<stri
   gallery: null;
   error: string;
   detailedError: string;
-}>;
-//#endregion
+}>;

package/dist/fetchers/gallery.mjs

@@ -6,7 +6,7 @@ import { parseGallery } from "../parsers/index.mjs";
 import { XMLGalleryData } from "../xml/schemas.mjs";
 import { OCHRE_RESPONSE_PADDING, compileOchreQuery, getContentLanguage, stringLiteral } from "../xquery.mjs";
 import * as v from "valibot";
-//#region src/fetchers/gallery.ts
+// src/fetchers/gallery.ts
 function buildXQuery(parameters) {
 	const { uuid, filter, page, perPage, contentLanguage } = parameters;
 	const start = (page - 1) * perPage + 1;
@@ -61,5 +61,4 @@ async function fetchGallery(parameters, options) {
 		};
 	}
 }
-//#endregion
 export { fetchGallery };

package/dist/fetchers/item-children.d.mts

@@ -1,6 +1,5 @@
 import { ContainedItemCategoryFromOption, ContainedItemCategoryOption, Item, ItemCategory, ItemCategoryFromOption, ItemCategoryOption, ItemContainerCategory, SetItemCategory, TreeItemCategory } from "../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-//#region src/fetchers/item-children.d.ts
 type FetchItemChildrenResult<TItems> = Promise<{
   items: TItems;
   error: null;
@@ -32,5 +31,4 @@ export declare function fetchItemChildren<const TCategory extends ItemCategoryOp
   category: TCategory;
   containedItemCategory?: TContainedItemCategory;
 }): FetchItemChildrenResult<Array<Item<TChildCategory, ContainedItemCategoryFromOption<TChildCategory, TContainedItemCategory>, FetchLanguages<TLanguages>, ItemChildrenPayloadKind<ItemCategoryFromOption<TCategory>>>>>;
-//#endregion
 export {};

package/dist/fetchers/item-children.mjs

@@ -7,7 +7,7 @@ import { parseLinkedItems } from "../parsers/index.mjs";
 import { XMLItemLinksData } from "../xml/schemas.mjs";
 import { OCHRE_RESPONSE_PADDING, compileOchreQuery, getContentLanguage, stringLiteral } from "../xquery.mjs";
 import * as v from "valibot";
-//#region src/fetchers/item-children.ts
+// src/fetchers/item-children.ts
 function buildXQuery(uuid, category, contentLanguage) {
 	const categories = category == null ? OCHRE_COLLECTION_CATEGORIES : typeof category === "string" ? [category] : category;
 	const collectionQueries = Array.from(categories, (possibleCategory) => `cts:search(fn:collection("ochre/${possibleCategory}")/ochre, $uuid-query)`);
@@ -81,5 +81,4 @@ async function fetchItemChildren(uuid, options) {
 		};
 	}
 }
-//#endregion
 export { fetchItemChildren };

package/dist/fetchers/item-links.d.mts

@@ -1,6 +1,5 @@
 import { ContainedItemCategoryFromOption, ContainedItemCategoryOption, Item, ItemCategory, ItemContainerCategory } from "../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-//#region src/fetchers/item-links.d.ts
 /**
  * Fetches linked OCHRE items by source-item UUID.
  *
@@ -21,5 +20,4 @@ export declare function fetchItemLinks<const TContainedItemCategory extends Cont
   items: null;
   error: string;
   detailedError: string;
-}>;
-//#endregion
+}>;

package/dist/fetchers/item-links.mjs

@@ -7,7 +7,7 @@ import { parseLinkedItems } from "../parsers/index.mjs";
 import { XMLItemLinksData } from "../xml/schemas.mjs";
 import { OCHRE_RESPONSE_PADDING, compileOchreQuery, getContentLanguage, stringLiteral } from "../xquery.mjs";
 import * as v from "valibot";
-//#region src/fetchers/item-links.ts
+// src/fetchers/item-links.ts
 /**
 * Build an XQuery string to fetch linked items from the OCHRE API.
 *
@@ -70,5 +70,4 @@ async function fetchItemLinks(uuid, options) {
 		};
 	}
 }
-//#endregion
 export { fetchItemLinks };

package/dist/fetchers/item-locations.d.mts

@@ -1,6 +1,5 @@
 import { ItemLocation, Query } from "../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-//#region src/fetchers/item-locations.d.ts
 /**
  * Fetches the location of every Set or Tree item that matches a query, without paging
  *
@@ -37,5 +36,4 @@ export declare function fetchItemLocations<const TLanguages extends ReadonlyArra
   items: null;
   error: string;
   detailedError: string;
-}>;
-//#endregion
+}>;

package/dist/fetchers/item-locations.mjs

@@ -9,7 +9,7 @@ import { XMLItemLocationsData } from "../xml/schemas.mjs";
 import { getContentLanguage, stringLiteral } from "../xquery.mjs";
 import { compileContainerItemsQuery } from "../query.mjs";
 import * as v from "valibot";
-//#region src/fetchers/item-locations.ts
+// src/fetchers/item-locations.ts
 async function fetchItemLocations(parameters, options) {
 	try {
 		const { setScopeUuids, treeScopeUuids, belongsToCollectionScopeUuids, queries, propertyVariableUuids, isMapDataIncluded } = v.parse(itemLocationsParametersSchema, parameters);
@@ -95,5 +95,4 @@ async function fetchItemLocations(parameters, options) {
 		};
 	}
 }
-//#endregion
 export { fetchItemLocations };

package/dist/fetchers/item-ocr-data.d.mts

@@ -1,6 +1,5 @@
 import { OcrString } from "../types/index.mjs";
 import { OchreRequestOptions } from "./request.mjs";
-//#region src/fetchers/item-ocr-data.d.ts
 /**
  * Fetches and parses the OCR strings of an OCHRE item that match a search value
  *
@@ -35,5 +34,4 @@ export declare function fetchItemOcrData(uuid: string, value: string, options?:
   ocrStrings: null;
   error: string;
   detailedError: string;
-}>;
-//#endregion
+}>;

package/dist/fetchers/item-ocr-data.mjs

@@ -4,7 +4,7 @@ import { itemOcrDataParametersSchema } from "../schemas.mjs";
 import { OCHRE_RESPONSE_PADDING, stringLiteral } from "../xquery.mjs";
 import { buildOcrWordPath } from "../ocr.mjs";
 import * as v from "valibot";
-//#region src/fetchers/item-ocr-data.ts
+// src/fetchers/item-ocr-data.ts
 const OCR_STRING_VERTEX_REGEX = /\(\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*\)/g;
 /**
 * Schema for a single matched OCR string in the OCHRE API response
@@ -164,5 +164,4 @@ async function fetchItemOcrData(uuid, value, options) {
 		};
 	}
 }
-//#endregion
 export { fetchItemOcrData };

package/dist/fetchers/item.d.mts

@@ -1,6 +1,5 @@
 import { ContainedItemCategoryFromOption, ContainedItemCategoryOption, Item, ItemCategory, ItemCategoryFromOption, ItemCategoryOption, ItemCategoryWithEmbeddedItems, ItemContainerCategory, ItemWithoutEmbeddedItems } from "../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-//#region src/fetchers/item.d.ts
 type FetchItemResult<TItem> = Promise<{
   item: TItem;
   error: null;
@@ -44,5 +43,4 @@ export declare function fetchItem<const TCategory extends ItemCategoryOption, co
   containedItemCategory?: TContainedItemCategory;
   shouldOmitEmbeddedItems: true;
 }): FetchItemResult<ItemWithoutEmbeddedItems<Extract<ItemCategoryFromOption<TCategory>, ItemCategoryWithEmbeddedItems>, ContainedItemCategoryFromOption<Extract<ItemCategoryFromOption<TCategory>, ItemCategoryWithEmbeddedItems>, TContainedItemCategory>, FetchLanguages<TLanguages>> | Item<Exclude<ItemCategoryFromOption<TCategory>, ItemCategoryWithEmbeddedItems>, never, FetchLanguages<TLanguages>>>;
-//#endregion
 export {};

package/dist/fetchers/item.mjs

@@ -8,7 +8,7 @@ import { XMLData } from "../xml/schemas.mjs";
 import { OCHRE_RESPONSE_PADDING, compileOchreQuery, getContentLanguage, stringLiteral } from "../xquery.mjs";
 import { parseWebpageView } from "../parsers/website/index.mjs";
 import * as v from "valibot";
-//#region src/fetchers/item.ts
+// src/fetchers/item.ts
 function isItemWithEmbeddedItems(item) {
 	return isItemCategoryWithEmbeddedItems(item.category);
 }
@@ -100,5 +100,4 @@ async function fetchItem(uuid, options) {
 		};
 	}
 }
-//#endregion
 export { fetchItem };

package/dist/fetchers/map-layers.d.mts

@@ -1,6 +1,5 @@
 import { MapLayer } from "../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-//#region src/fetchers/map-layers.d.ts
 /**
  * Fetches the layers a map draws from the Sets and Trees it links to
  *
@@ -26,5 +25,4 @@ export declare function fetchMapLayers<const TLanguages extends ReadonlyArray<st
   layers: null;
   error: string;
   detailedError: string;
-}>;
-//#endregion
+}>;

package/dist/fetchers/map-layers.mjs

@@ -6,7 +6,7 @@ import { parseIdentification } from "../parsers/index.mjs";
 import { XMLMapSourcesData } from "../xml/schemas.mjs";
 import { OCHRE_RESPONSE_PADDING, compileOchreQuery, getContentLanguage, stringLiteral } from "../xquery.mjs";
 import * as v from "valibot";
-//#region src/fetchers/map-layers.ts
+// src/fetchers/map-layers.ts
 const REGEX_TILE_TEMPLATE_LEVEL = /\{(?:level|z)\}/i;
 const REGEX_TILE_TEMPLATE_ROW = /\{(?:row|y)\}/i;
 const REGEX_TILE_TEMPLATE_COLUMN = /\{(?:col|x)\}/i;
@@ -157,5 +157,4 @@ async function fetchMapLayers(uuids, options) {
 		};
 	}
 }
-//#endregion
 export { fetchMapLayers };

package/dist/fetchers/request.d.mts

@@ -1,6 +1,5 @@
 import { FetchFunction } from "../parsers/helpers.mjs";
 import * as v from "valibot";
-//#region src/fetchers/request.d.ts
 export type OchreRequestOptions = {
   fetch?: FetchFunction;
   signal?: AbortSignal;
@@ -66,5 +65,4 @@ export declare function isOchreJsonAccepted(parameters: {
   body: unknown;
   label: string;
   options?: OchreRequestOptions;
-}): Promise<boolean>;
-//#endregion
+}): Promise<boolean>;

package/dist/fetchers/request.mjs

@@ -3,7 +3,7 @@ import { createSchemaValidationError } from "../errors.mjs";
 import { restoreXMLMetadata } from "../xml/metadata.mjs";
 import * as v from "valibot";
 import { XMLParser } from "fast-xml-parser";
-//#region src/fetchers/request.ts
+// src/fetchers/request.ts
 const OCHRE_XQUERY_ENDPOINT = `${OCHRE_ENDPOINT}?xquery&xsl=none&lang="*"`;
 const xmlParser = new XMLParser(XML_PARSER_OPTIONS);
 function resolveSignal(options) {
@@ -97,5 +97,4 @@ async function isOchreJsonAccepted(parameters) {
 	if (response.status >= 500) throw new Error(`Failed to post ${label}: OCHRE API responded with status ${response.status}`, { cause: response.statusText });
 	return response.ok;
 }
-//#endregion
 export { decodeOchreResponse, isOchreJsonAccepted, requestOchre };

package/dist/fetchers/set/items.d.mts

@@ -1,6 +1,5 @@
 import { Query, SetItem, SetItemCategory, SetItemsSort } from "../../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../../parsers/helpers.mjs";
-//#region src/fetchers/set/items.d.ts
 type FetchSetItemsCategory<TContainedItemCategories extends ReadonlyArray<SetItemCategory> | undefined> = TContainedItemCategories extends ReadonlyArray<infer U> ? Extract<U, SetItemCategory> : SetItemCategory;
 /**
  * Fetches and parses Set items from the OCHRE API
@@ -38,5 +37,4 @@ export declare function fetchSetItems<const TContainedItemCategories extends Rea
   error: string;
   detailedError: string;
 }>;
-//#endregion
 export {};

package/dist/fetchers/set/items.mjs

@@ -2,7 +2,7 @@ import { getErrorOutput } from "../../errors.mjs";
 import { setItemsParametersSchema } from "../../schemas.mjs";
 import { fetchContainerItems } from "../container-items.mjs";
 import * as v from "valibot";
-//#region src/fetchers/set/items.ts
+// src/fetchers/set/items.ts
 async function fetchSetItems(parameters, containedItemCategories, options) {
 	try {
 		const { setScopeUuids, belongsToCollectionScopeUuids, queries, sort, page, pageSize } = v.parse(setItemsParametersSchema, parameters);
@@ -32,5 +32,4 @@ async function fetchSetItems(parameters, containedItemCategories, options) {
 		};
 	}
 }
-//#endregion
 export { fetchSetItems };

package/dist/fetchers/set/property-values.d.mts

@@ -1,6 +1,5 @@
 import { PropertyValueQueryItem, Query, SetAttributeValueQueryItem } from "../../types/index.mjs";
 import { OchreRequestOptions } from "../request.mjs";
-//#region src/fetchers/set/property-values.d.ts
 /**
  * Fetches and parses Set property values from the OCHRE API
  *
@@ -41,5 +40,4 @@ export declare function fetchSetPropertyValues(parameters: {
   attributeValues: null;
   error: string;
   detailedError: string;
-}>;
-//#endregion
+}>;

package/dist/fetchers/set/property-values.mjs

@@ -7,7 +7,7 @@ import { parseXMLContent } from "../../parsers/string.mjs";
 import { stringLiteral } from "../../xquery.mjs";
 import { compileContainerItemsQuery, getItemFilterQueries, getPropertyFacetSelectors } from "../../query.mjs";
 import * as v from "valibot";
-//#region src/fetchers/set/property-values.ts
+// src/fetchers/set/property-values.ts
 function getLabelContentLanguages(content) {
 	const languages = [];
 	for (const contentItem of content) if (contentItem.lang !== "zxx" && !languages.includes(contentItem.lang)) languages.push(contentItem.lang);
@@ -491,5 +491,4 @@ async function fetchSetPropertyValues(parameters, options) {
 		};
 	}
 }
-//#endregion
 export { fetchSetPropertyValues };

package/dist/fetchers/tree/items.d.mts

@@ -1,6 +1,5 @@
 import { Query, SetItem, SetItemsSort, TreeItemCategory } from "../../types/index.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../../parsers/helpers.mjs";
-//#region src/fetchers/tree/items.d.ts
 type FetchTreeItemsCategory<TContainedItemCategories extends ReadonlyArray<TreeItemCategory> | undefined> = TContainedItemCategories extends ReadonlyArray<infer U> ? Extract<U, TreeItemCategory> : TreeItemCategory;
 /**
  * Fetches and parses Tree items from the OCHRE API
@@ -50,5 +49,4 @@ export declare function fetchTreeItems<const TContainedItemCategories extends Re
   error: string;
   detailedError: string;
 }>;
-//#endregion
 export {};

package/dist/fetchers/tree/items.mjs

@@ -2,7 +2,7 @@ import { getErrorOutput } from "../../errors.mjs";
 import { treeItemsParametersSchema } from "../../schemas.mjs";
 import { fetchContainerItems } from "../container-items.mjs";
 import * as v from "valibot";
-//#region src/fetchers/tree/items.ts
+// src/fetchers/tree/items.ts
 async function fetchTreeItems(parameters, containedItemCategories, options) {
 	try {
 		const { treeScopeUuids, belongsToCollectionScopeUuids, queries, sort, page, pageSize } = v.parse(treeItemsParametersSchema, parameters);
@@ -34,5 +34,4 @@ async function fetchTreeItems(parameters, containedItemCategories, options) {
 		};
 	}
 }
-//#endregion
 export { fetchTreeItems };

package/dist/fetchers/website-metadata.d.mts

@@ -1,6 +1,5 @@
 import { WebsiteMetadata } from "../types/website.mjs";
 import { FetchBaseOptions, FetchLanguages } from "../parsers/helpers.mjs";
-//#region src/fetchers/website-metadata.d.ts
 /**
  * Fetches and parses a page-scoped website metadata projection from the OCHRE
  * API.
@@ -15,5 +14,4 @@ export declare function fetchWebsiteMetadata<const TLanguages extends ReadonlyAr
   websiteMetadata: null;
   error: string;
   detailedError: string;
-}>;
-//#endregion
+}>;

package/dist/fetchers/website-metadata.mjs

@@ -7,7 +7,7 @@ import { XMLWebsiteData } from "../xml/schemas.mjs";
 import { OCHRE_RESPONSE_PADDING, compileOchreQuery, stringLiteral } from "../xquery.mjs";
 import { websitePresentationReader } from "../parsers/website/reader.mjs";
 import { WEBSITE_WALK_DECLARATIONS } from "../parsers/website/walk.mjs";
-//#region src/fetchers/website-metadata.ts
+// src/fetchers/website-metadata.ts
 /**
 * The presentation properties the metadata projection carries
 *
@@ -154,5 +154,4 @@ async function fetchWebsiteMetadata(abbreviation, options) {
 		};
 	}
 }
-//#endregion
 export { fetchWebsiteMetadata };

package/dist/fetchers/website.d.mts

@@ -1,7 +1,6 @@
 import { ProtectedWebsite, Website } from "../types/website.mjs";
 import { LanguageCodes } from "../types/index.mjs";
 import { OchreRequestOptions } from "./request.mjs";
-//#region src/fetchers/website.d.ts
 /**
  * Fetches and parses a website configuration from the OCHRE API.
  *
@@ -32,5 +31,4 @@ export declare function fetchWebsite<const T extends LanguageCodes = LanguageCod
   protectedWebsite: null;
   error: string;
   detailedError: string;
-}>;
-//#endregion
+}>;

package/dist/fetchers/website.mjs

@@ -4,7 +4,7 @@ import { parseLanguages } from "../parsers/languages.mjs";
 import { XMLWebsiteData } from "../xml/schemas.mjs";
 import { OCHRE_RESPONSE_PADDING, compileOchreQuery, stringLiteral } from "../xquery.mjs";
 import { parseWebsite } from "../parsers/website/index.mjs";
-//#region src/fetchers/website.ts
+// src/fetchers/website.ts
 async function areWebsiteCredentialsValid(uuid, credentials, options) {
 	const security = typeof credentials === "string" ? { validate: credentials } : {
 		validate: credentials.password,
@@ -87,5 +87,4 @@ async function fetchWebsite(abbreviation, options) {
 		};
 	}
 }
-//#endregion
 export { fetchWebsite };

package/dist/getters.d.mts

@@ -1,5 +1,4 @@
 import { LanguageCodes, PropertyLike, PropertyValueContent } from "./types/index.mjs";
-//#region src/getters.d.ts
 /**
  * Options for property search operations.
  */
@@ -135,5 +134,4 @@ export declare function isPropertyMatchingFilter<T extends LanguageCodes = Langu
   variableLabel: string;
   value: PropertyValueContent<T>;
 }, options?: PropertyOptions): boolean;
-//#endregion
 export {};

package/dist/getters.mjs

@@ -1,5 +1,5 @@
 import { deepEqual } from "fast-equals";
-//#region src/getters.ts
+// src/getters.ts
 /**
 * The variable label that asks a filter to match against every property
 */
@@ -233,5 +233,4 @@ function isPropertyMatchingFilter(property, filter, options = DEFAULT_OPTIONS) {
 	}
 	return false;
 }
-//#endregion
 export { getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel };

package/dist/helpers.d.mts

@@ -1,5 +1,4 @@
 import { ContainedItemCategory, Item, ItemCategory, ItemPayloadKind, LanguageCodes, SetItemProperty } from "./types/index.mjs";
-//#region src/helpers.d.ts
 type FlattenedItem<U, T extends LanguageCodes> = Omit<U, "properties"> & {
   properties: Array<SetItemProperty<T>>;
 };
@@ -9,5 +8,4 @@ type FlattenedItem<U, T extends LanguageCodes> = Omit<U, "properties"> & {
  * @returns The item with the properties flattened
  */
 export declare function flattenItemProperties<U extends ItemCategory = ItemCategory, V extends ContainedItemCategory<U> = ContainedItemCategory<U>, T extends LanguageCodes = LanguageCodes, W extends ItemPayloadKind = "topLevel">(item: Item<U, V, T, W>): FlattenedItem<Item<U, V, T, W>, T>;
-//#endregion
 export {};

package/dist/helpers.mjs

@@ -1,4 +1,4 @@
-//#region src/helpers.ts
+// src/helpers.ts
 /**
 * Flatten the properties of an item
 * @param item - The item whose properties to flatten
@@ -42,5 +42,4 @@ function flattenProperties(properties) {
 	}
 	return result;
 }
-//#endregion
 export { flattenItemProperties };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { MultilingualOptions, MultilingualString, MultilingualStringEntries, MultilingualStringEntry, MultilingualStringInput, MultilingualStringJSON, MultilingualStringObject, MultilingualStringText } from "./parsers/multilingual.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, WebRelationVariant, 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, ItemLocation, ItemPayloadKind, ItemProperty, ItemWithoutEmbeddedItems, LanguageCodes, License, MapLayer, 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, SetStyle, SetStyleProperty, SetTree, SimplifiedProperty, SpatialUnit, SpatialUnitItemLink, Text, TextItemLink, TopLevelItem, Tree, TreeItemCategory, TreeItemLink } from "./types/index.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, DownloadOption, 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, ItemLocation, ItemPayloadKind, ItemProperty, ItemWithoutEmbeddedItems, LanguageCodes, License, MapLayer, 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, SetStyle, SetStyleProperty, 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";
@@ -18,4 +18,4 @@ import { PropertyOptions, PropertySelector, getLeafPropertyValues, getProperty,
 import { flattenItemProperties } from "./helpers.mjs";
 import { OCHRE_LANGUAGES, OchreLanguage, OchreLanguageCode, OchreLanguageKind, OchreLanguageStandard, getOchreLanguage, getOchreLanguageCode, isOchreLanguageCode } from "./languages.mjs";
 import { defineLanguages } from "./parsers/languages.mjs";
-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 ItemLocation, type ItemPayloadKind, type ItemProperty, type ItemWithoutEmbeddedItems, type LanguageCodes, type License, type MapLayer, type Metadata, type MultilingualOptions, MultilingualString, type MultilingualStringEntries, type MultilingualStringEntry, type MultilingualStringInput, type MultilingualStringJSON, type MultilingualStringObject, type MultilingualStringText, type Note, OCHRE_LANGUAGES, type Observation, type OchreLanguage, type OchreLanguageCode, type OchreLanguageKind, type OchreLanguageStandard, 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 SetStyle, type SetStyleProperty, 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 WebRelationVariant, 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, fetchItemLocations, fetchItemOcrData, fetchMapLayers, fetchSetItems, fetchSetPropertyValues, fetchTreeItems, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getLeafPropertyValues, getOchreLanguage, getOchreLanguageCode, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isOchreLanguageCode, 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 DownloadOption, 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 ItemLocation, type ItemPayloadKind, type ItemProperty, type ItemWithoutEmbeddedItems, type LanguageCodes, type License, type MapLayer, type Metadata, type MultilingualOptions, MultilingualString, type MultilingualStringEntries, type MultilingualStringEntry, type MultilingualStringInput, type MultilingualStringJSON, type MultilingualStringObject, type MultilingualStringText, type Note, OCHRE_LANGUAGES, type Observation, type OchreLanguage, type OchreLanguageCode, type OchreLanguageKind, type OchreLanguageStandard, 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 SetStyle, type SetStyleProperty, 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 WebRelationVariant, 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, fetchItemLocations, fetchItemOcrData, fetchMapLayers, fetchSetItems, fetchSetPropertyValues, fetchTreeItems, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getLeafPropertyValues, getOchreLanguage, getOchreLanguageCode, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isOchreLanguageCode, isPropertyMatchingFilter, normalizePropertyVariableLabel };

package/dist/languages.d.mts

@@ -1,4 +1,3 @@
-//#region src/languages.d.ts
 /**
  * What an OCHRE language code tags
  *
@@ -672,5 +671,4 @@ export declare function getOchreLanguage(code: string): OchreLanguage | null;
  * @returns The OCHRE code of the language itself, not of a transliteration,
  * or null when OCHRE publishes no code for it
  */
-export declare function getOchreLanguageCode(iso639_3: string): OchreLanguageCode | null;
-//#endregion
+export declare function getOchreLanguageCode(iso639_3: string): OchreLanguageCode | null;