ochre-sdk 1.3.5 → 1.3.6

package/README.md

@@ -100,11 +100,14 @@ title.isEmpty();
 title.hasContent();
 title.hasLanguage("tur");
 title.hasAliases();
+title.isNonLinguistic();
 
 title.getAvailableLanguages(); // languages that carry content
 title.getSupportedLanguages(); // languages the string was built to hold
 ```
 
+OCHRE publishes `zxx` content in two senses, and the string tells them apart by the only thing that distinguishes them: whether another language stands beside it. Beside a field's languages, `zxx` content names the same thing again, so it is read as aliases (`getAliases()`). Standing alone, it is the text itself in no language, such as an identifier, so it is read as non-linguistic text: `isNonLinguistic()` is true, every language reads it through `getText`, and it has no aliases. Every string, however it is built or edited, follows the same rule, so adding a language to a non-linguistic string turns its text into aliases, as the same content would be read.
+
 Writes return a new string and never mutate the original.
 
 ```ts
@@ -129,6 +132,20 @@ const languages = defineLanguages("eng", "tur");
 const result = await fetchWebsite("uchicago-node", { languages });
 ```
 
+## Language Codes
+
+OCHRE publishes ISO 639-2/B language codes, the Library of Congress MARC convention, and every language the SDK reads or accepts uses them: the bibliographic code wherever ISO 639-2 has one (`per` for Persian, not ISO 639-3 `fas`; `fre`, `chi`, `ger`), the ISO 639-3 identifier where it has none (`yua`, `lzh`), and a few codes of its own for transliterations and vocabularies (`ota-xlt`, `rel`), some of which collide with unrelated ISO 639-3 languages. Requests in any other code are rejected, with the OCHRE code to use when one exists.
+
+`OCHRE_LANGUAGES` maps every code OCHRE publishes to its name, what it tags (a `language`, a `transliteration`, a `vocabulary` or `non-linguistic` content), its ISO 639-3 identifier and the BCP 47 tag to give `Intl` or an HTML `lang` attribute. Either standard is `null` when none fits.
+
+```ts
+import { getOchreLanguage, getOchreLanguageCode } from "ochre-sdk";
+
+getOchreLanguage("per"); // { name: "Persian", kind: "language", iso639_3: "fas", bcp47: "fa" }
+getOchreLanguage("ota-xlt")?.bcp47; // "ota-Latn-t-ota-arab"
+getOchreLanguageCode("fas"); // "per"
+```
+
 ## Set Queries
 
 Set fetchers accept a recursive `Query` tree. Leaf queries can target full text,

package/dist/index.d.mts

@@ -15,5 +15,6 @@ import { fetchWebsiteMetadata } from "./fetchers/website-metadata.mjs";
 import { fetchWebsite } from "./fetchers/website.mjs";
 import { PropertyOptions, PropertySelector, getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel } from "./getters.mjs";
 import { flattenItemProperties } from "./helpers.mjs";
+import { OCHRE_LANGUAGES, OchreLanguage, OchreLanguageCode, OchreLanguageKind, 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 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 SetItemLocation, 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, fetchItemOcrData, fetchSetItemLocations, fetchSetItems, fetchSetPropertyValues, fetchTreeItems, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getLeafPropertyValues, 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, OCHRE_LANGUAGES, type Observation, type OchreLanguage, type OchreLanguageCode, type OchreLanguageKind, 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 SetItemLocation, 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, fetchItemOcrData, fetchSetItemLocations, fetchSetItems, fetchSetPropertyValues, fetchTreeItems, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getLeafPropertyValues, getOchreLanguage, getOchreLanguageCode, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isOchreLanguageCode, isPropertyMatchingFilter, normalizePropertyVariableLabel };

package/dist/index.mjs

@@ -2,6 +2,7 @@ import { DEFAULT_PAGE_SIZE } from "./constants.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 { OCHRE_LANGUAGES, getOchreLanguage, getOchreLanguageCode, isOchreLanguageCode } from "./languages.mjs";
 import { defineLanguages } from "./parsers/languages.mjs";
 import { fetchGallery } from "./fetchers/gallery.mjs";
 import { fetchItemChildren } from "./fetchers/item-children.mjs";
@@ -14,4 +15,4 @@ import { fetchSetPropertyValues } from "./fetchers/set/property-values.mjs";
 import { fetchTreeItems } from "./fetchers/tree/items.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, fetchSetItemLocations, fetchSetItems, fetchSetPropertyValues, fetchTreeItems, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getLeafPropertyValues, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isPropertyMatchingFilter, normalizePropertyVariableLabel };
+export { DEFAULT_PAGE_SIZE, MultilingualString, OCHRE_LANGUAGES, defineLanguages, fetchGallery, fetchItem, fetchItemChildren, fetchItemLinks, fetchItemOcrData, fetchSetItemLocations, fetchSetItems, fetchSetPropertyValues, fetchTreeItems, fetchWebsite, fetchWebsiteMetadata, flattenItemProperties, getLeafPropertyValues, getOchreLanguage, getOchreLanguageCode, getProperty, getPropertyValue, getPropertyValues, getUniqueProperties, getUniquePropertyVariableLabels, isOchreLanguageCode, isPropertyMatchingFilter, normalizePropertyVariableLabel };

package/dist/languages.d.mts

@@ -0,0 +1,582 @@
+//#region src/languages.d.ts
+/**
+ * What an OCHRE language code tags
+ *
+ * - `language`: text in a natural language
+ * - `transliteration`: a language written in another script (`ota-xlt`)
+ * - `vocabulary`: codes or notation that are not a language (`rel`)
+ * - `non-linguistic`: `zxx`, which OCHRE publishes for aliases and for
+ *   labels that are not in any language
+ */
+export type OchreLanguageKind = "language" | "transliteration" | "vocabulary" | "non-linguistic";
+/**
+ * A language code OCHRE publishes, with the standard codes it stands for
+ */
+export type OchreLanguage = {
+  /**
+   * The English name of the language
+   */
+  name: string;
+  /**
+   * What the code tags
+   */
+  kind: OchreLanguageKind;
+  /**
+   * The ISO 639-3 identifier of the language, or null when the code tags
+   * no language, or a language ISO 639-3 does not code
+   */
+  iso639_3: string | null;
+  /**
+   * The BCP 47 tag to hand to `Intl` and HTML `lang` attributes, or null
+   * when no standard tag fits
+   */
+  bcp47: string | null;
+};
+/**
+ * Every language code OCHRE publishes, mapped to the ISO 639-3 and BCP 47
+ * codes it stands for
+ *
+ * OCHRE publishes ISO 639-2/B codes, the Library of Congress MARC
+ * convention: the bibliographic code wherever ISO 639-2 has one (`per`,
+ * not ISO 639-3 `fas`), the ISO 639-3 identifier where it has none
+ * (`yua`), and a few codes of its own (`ota-xlt`, `rel`), some of which
+ * collide with unrelated ISO 639-3 languages. Key everything by these codes,
+ * because they are what OCHRE serves, and convert through this table when a
+ * standard code is needed.
+ */
+export declare const OCHRE_LANGUAGES: {
+  readonly akk: {
+    readonly name: "Akkadian";
+    readonly kind: "language";
+    readonly iso639_3: "akk";
+    readonly bcp47: "akk";
+  };
+  readonly xno: {
+    readonly name: "Anglo-Norman";
+    readonly kind: "language";
+    readonly iso639_3: "xno";
+    readonly bcp47: "xno";
+  };
+  readonly ara: {
+    readonly name: "Arabic";
+    readonly kind: "language";
+    readonly iso639_3: "ara";
+    readonly bcp47: "ar";
+  };
+  readonly arc: {
+    readonly name: "Aramaic";
+    readonly kind: "language";
+    readonly iso639_3: "arc";
+    readonly bcp47: "arc";
+  };
+  readonly arm: {
+    readonly name: "Armenian";
+    readonly kind: "language";
+    readonly iso639_3: "hye";
+    readonly bcp47: "hy";
+  };
+  readonly bel: {
+    readonly name: "Belarusian";
+    readonly kind: "language";
+    readonly iso639_3: "bel";
+    readonly bcp47: "be";
+  };
+  readonly ben: {
+    readonly name: "Bengali";
+    readonly kind: "language";
+    readonly iso639_3: "ben";
+    readonly bcp47: "bn";
+  };
+  readonly btc: {
+    readonly name: "Betacode";
+    readonly kind: "vocabulary";
+    readonly iso639_3: null;
+    readonly bcp47: "grc-Latn-x-betacode";
+  };
+  readonly bos: {
+    readonly name: "Bosnian";
+    readonly kind: "language";
+    readonly iso639_3: "bos";
+    readonly bcp47: "bs";
+  };
+  readonly bul: {
+    readonly name: "Bulgarian";
+    readonly kind: "language";
+    readonly iso639_3: "bul";
+    readonly bcp47: "bg";
+  };
+  readonly cnn: {
+    readonly name: "Canaanite";
+    readonly kind: "language";
+    readonly iso639_3: null;
+    readonly bcp47: null;
+  };
+  readonly yue: {
+    readonly name: "Cantonese";
+    readonly kind: "language";
+    readonly iso639_3: "yue";
+    readonly bcp47: "yue";
+  };
+  readonly cat: {
+    readonly name: "Catalan";
+    readonly kind: "language";
+    readonly iso639_3: "cat";
+    readonly bcp47: "ca";
+  };
+  readonly chi: {
+    readonly name: "Chinese";
+    readonly kind: "language";
+    readonly iso639_3: "zho";
+    readonly bcp47: "zh";
+  };
+  readonly chu: {
+    readonly name: "Church Slavonic";
+    readonly kind: "language";
+    readonly iso639_3: "chu";
+    readonly bcp47: "cu";
+  };
+  readonly lzh: {
+    readonly name: "Classical Chinese";
+    readonly kind: "language";
+    readonly iso639_3: "lzh";
+    readonly bcp47: "lzh";
+  };
+  readonly cop: {
+    readonly name: "Coptic";
+    readonly kind: "language";
+    readonly iso639_3: "cop";
+    readonly bcp47: "cop";
+  };
+  readonly hrv: {
+    readonly name: "Croatian";
+    readonly kind: "language";
+    readonly iso639_3: "hrv";
+    readonly bcp47: "hr";
+  };
+  readonly cze: {
+    readonly name: "Czech";
+    readonly kind: "language";
+    readonly iso639_3: "ces";
+    readonly bcp47: "cs";
+  };
+  readonly egyd: {
+    readonly name: "Demotic";
+    readonly kind: "language";
+    readonly iso639_3: "egy";
+    readonly bcp47: "egy-Egyd";
+  };
+  readonly nld: {
+    readonly name: "Dutch";
+    readonly kind: "language";
+    readonly iso639_3: "nld";
+    readonly bcp47: "nl";
+  };
+  readonly dum: {
+    readonly name: "Dutch (Middle)";
+    readonly kind: "language";
+    readonly iso639_3: "dum";
+    readonly bcp47: "dum";
+  };
+  readonly egy: {
+    readonly name: "Egyptian";
+    readonly kind: "language";
+    readonly iso639_3: "egy";
+    readonly bcp47: "egy";
+  };
+  readonly elx: {
+    readonly name: "Elamite";
+    readonly kind: "language";
+    readonly iso639_3: "elx";
+    readonly bcp47: "elx";
+  };
+  readonly eng: {
+    readonly name: "English";
+    readonly kind: "language";
+    readonly iso639_3: "eng";
+    readonly bcp47: "en";
+  };
+  readonly enm: {
+    readonly name: "English (Middle)";
+    readonly kind: "language";
+    readonly iso639_3: "enm";
+    readonly bcp47: "enm";
+  };
+  readonly ecy: {
+    readonly name: "Eteocypriot";
+    readonly kind: "language";
+    readonly iso639_3: "ecy";
+    readonly bcp47: "ecy";
+  };
+  readonly fre: {
+    readonly name: "French";
+    readonly kind: "language";
+    readonly iso639_3: "fra";
+    readonly bcp47: "fr";
+  };
+  readonly frm: {
+    readonly name: "French (Middle)";
+    readonly kind: "language";
+    readonly iso639_3: "frm";
+    readonly bcp47: "frm";
+  };
+  readonly fro: {
+    readonly name: "French (Old)";
+    readonly kind: "language";
+    readonly iso639_3: "fro";
+    readonly bcp47: "fro";
+  };
+  readonly geo: {
+    readonly name: "Georgian";
+    readonly kind: "language";
+    readonly iso639_3: "kat";
+    readonly bcp47: "ka";
+  };
+  readonly ger: {
+    readonly name: "German";
+    readonly kind: "language";
+    readonly iso639_3: "deu";
+    readonly bcp47: "de";
+  };
+  readonly nds: {
+    readonly name: "German (Low)";
+    readonly kind: "language";
+    readonly iso639_3: "nds";
+    readonly bcp47: "nds";
+  };
+  readonly gmh: {
+    readonly name: "German (Middle High)";
+    readonly kind: "language";
+    readonly iso639_3: "gmh";
+    readonly bcp47: "gmh";
+  };
+  readonly goh: {
+    readonly name: "German (Old High)";
+    readonly kind: "language";
+    readonly iso639_3: "goh";
+    readonly bcp47: "goh";
+  };
+  readonly grc: {
+    readonly name: "Greek";
+    readonly kind: "language";
+    readonly iso639_3: "grc";
+    readonly bcp47: "grc";
+  };
+  readonly guj: {
+    readonly name: "Gujarati";
+    readonly kind: "language";
+    readonly iso639_3: "guj";
+    readonly bcp47: "gu";
+  };
+  readonly "zh-Latn-pinyin": {
+    readonly name: "Hanyu Pinyin";
+    readonly kind: "transliteration";
+    readonly iso639_3: "cmn";
+    readonly bcp47: "zh-Latn-pinyin";
+  };
+  readonly htt: {
+    readonly name: "Hattian";
+    readonly kind: "language";
+    readonly iso639_3: "xht";
+    readonly bcp47: "xht";
+  };
+  readonly heb: {
+    readonly name: "Hebrew";
+    readonly kind: "language";
+    readonly iso639_3: "heb";
+    readonly bcp47: "he";
+  };
+  readonly hin: {
+    readonly name: "Hindi";
+    readonly kind: "language";
+    readonly iso639_3: "hin";
+    readonly bcp47: "hi";
+  };
+  readonly hit: {
+    readonly name: "Hittite";
+    readonly kind: "language";
+    readonly iso639_3: "hit";
+    readonly bcp47: "hit";
+  };
+  readonly xhu: {
+    readonly name: "Hurrian";
+    readonly kind: "language";
+    readonly iso639_3: "xhu";
+    readonly bcp47: "xhu";
+  };
+  readonly ita: {
+    readonly name: "Italian";
+    readonly kind: "language";
+    readonly iso639_3: "ita";
+    readonly bcp47: "it";
+  };
+  readonly jpn: {
+    readonly name: "Japanese";
+    readonly kind: "language";
+    readonly iso639_3: "jpn";
+    readonly bcp47: "ja";
+  };
+  readonly "jpn-xlt": {
+    readonly name: "Japanese XLit";
+    readonly kind: "transliteration";
+    readonly iso639_3: "jpn";
+    readonly bcp47: "ja-Latn-t-ja";
+  };
+  readonly kaz: {
+    readonly name: "Kazakh";
+    readonly kind: "language";
+    readonly iso639_3: "kaz";
+    readonly bcp47: "kk";
+  };
+  readonly kor: {
+    readonly name: "Korean";
+    readonly kind: "language";
+    readonly iso639_3: "kor";
+    readonly bcp47: "ko";
+  };
+  readonly lmc: {
+    readonly name: "Late Middle Chinese";
+    readonly kind: "language";
+    readonly iso639_3: "ltc";
+    readonly bcp47: "ltc";
+  };
+  readonly lat: {
+    readonly name: "Latin";
+    readonly kind: "language";
+    readonly iso639_3: "lat";
+    readonly bcp47: "la";
+  };
+  readonly xlt: {
+    readonly name: "Latin XLit";
+    readonly kind: "transliteration";
+    readonly iso639_3: null;
+    readonly bcp47: "und-Latn";
+  };
+  readonly luw: {
+    readonly name: "Luwian";
+    readonly kind: "language";
+    readonly iso639_3: null;
+    readonly bcp47: null;
+  };
+  readonly cmn: {
+    readonly name: "Mandarin";
+    readonly kind: "language";
+    readonly iso639_3: "cmn";
+    readonly bcp47: "cmn";
+  };
+  readonly mar: {
+    readonly name: "Marathi";
+    readonly kind: "language";
+    readonly iso639_3: "mar";
+    readonly bcp47: "mr";
+  };
+  readonly met: {
+    readonly name: "Metrical";
+    readonly kind: "vocabulary";
+    readonly iso639_3: null;
+    readonly bcp47: null;
+  };
+  readonly zxx: {
+    readonly name: "No linguistic content";
+    readonly kind: "non-linguistic";
+    readonly iso639_3: "zxx";
+    readonly bcp47: "zxx";
+  };
+  readonly och: {
+    readonly name: "Old Chinese";
+    readonly kind: "language";
+    readonly iso639_3: "och";
+    readonly bcp47: "och";
+  };
+  readonly peo: {
+    readonly name: "Old Persian";
+    readonly kind: "language";
+    readonly iso639_3: "peo";
+    readonly bcp47: "peo";
+  };
+  readonly ota: {
+    readonly name: "Ottoman Turkish";
+    readonly kind: "language";
+    readonly iso639_3: "ota";
+    readonly bcp47: "ota";
+  };
+  readonly "ota-xlt": {
+    readonly name: "Ottoman Turkish XLit";
+    readonly kind: "transliteration";
+    readonly iso639_3: "ota";
+    readonly bcp47: "ota-Latn-t-ota-arab";
+  };
+  readonly pla: {
+    readonly name: "Palaic";
+    readonly kind: "language";
+    readonly iso639_3: "plq";
+    readonly bcp47: "plq";
+  };
+  readonly per: {
+    readonly name: "Persian";
+    readonly kind: "language";
+    readonly iso639_3: "fas";
+    readonly bcp47: "fa";
+  };
+  readonly phn: {
+    readonly name: "Phoenician";
+    readonly kind: "language";
+    readonly iso639_3: "phn";
+    readonly bcp47: "phn";
+  };
+  readonly xpg: {
+    readonly name: "Phrygian";
+    readonly kind: "language";
+    readonly iso639_3: "xpg";
+    readonly bcp47: "xpg";
+  };
+  readonly pol: {
+    readonly name: "Polish";
+    readonly kind: "language";
+    readonly iso639_3: "pol";
+    readonly bcp47: "pl";
+  };
+  readonly por: {
+    readonly name: "Portuguese";
+    readonly kind: "language";
+    readonly iso639_3: "por";
+    readonly bcp47: "pt";
+  };
+  readonly pro: {
+    readonly name: "Pronunciation";
+    readonly kind: "vocabulary";
+    readonly iso639_3: null;
+    readonly bcp47: null;
+  };
+  readonly rel: {
+    readonly name: "Relator";
+    readonly kind: "vocabulary";
+    readonly iso639_3: null;
+    readonly bcp47: "zxx";
+  };
+  readonly rus: {
+    readonly name: "Russian";
+    readonly kind: "language";
+    readonly iso639_3: "rus";
+    readonly bcp47: "ru";
+  };
+  readonly san: {
+    readonly name: "Sanskrit";
+    readonly kind: "language";
+    readonly iso639_3: "san";
+    readonly bcp47: "sa";
+  };
+  readonly srp: {
+    readonly name: "Serbian";
+    readonly kind: "language";
+    readonly iso639_3: "srp";
+    readonly bcp47: "sr";
+  };
+  readonly spa: {
+    readonly name: "Spanish";
+    readonly kind: "language";
+    readonly iso639_3: "spa";
+    readonly bcp47: "es";
+  };
+  readonly sux: {
+    readonly name: "Sumerian";
+    readonly kind: "language";
+    readonly iso639_3: "sux";
+    readonly bcp47: "sux";
+  };
+  readonly sup: {
+    readonly name: "Supplemental";
+    readonly kind: "vocabulary";
+    readonly iso639_3: null;
+    readonly bcp47: null;
+  };
+  readonly syc: {
+    readonly name: "Syriac";
+    readonly kind: "language";
+    readonly iso639_3: "syc";
+    readonly bcp47: "syc";
+  };
+  readonly tei: {
+    readonly name: "TEI";
+    readonly kind: "vocabulary";
+    readonly iso639_3: null;
+    readonly bcp47: null;
+  };
+  readonly tur: {
+    readonly name: "Turkish";
+    readonly kind: "language";
+    readonly iso639_3: "tur";
+    readonly bcp47: "tr";
+  };
+  readonly uga: {
+    readonly name: "Ugaritic";
+    readonly kind: "language";
+    readonly iso639_3: "uga";
+    readonly bcp47: "uga";
+  };
+  readonly ukr: {
+    readonly name: "Ukrainian";
+    readonly kind: "language";
+    readonly iso639_3: "ukr";
+    readonly bcp47: "uk";
+  };
+  readonly urd: {
+    readonly name: "Urdu";
+    readonly kind: "language";
+    readonly iso639_3: "urd";
+    readonly bcp47: "ur";
+  };
+  readonly uzb: {
+    readonly name: "Uzbek";
+    readonly kind: "language";
+    readonly iso639_3: "uzb";
+    readonly bcp47: "uz";
+  };
+  readonly var: {
+    readonly name: "Variation";
+    readonly kind: "vocabulary";
+    readonly iso639_3: null;
+    readonly bcp47: null;
+  };
+  readonly was: {
+    readonly name: "Washo";
+    readonly kind: "language";
+    readonly iso639_3: "was";
+    readonly bcp47: "was";
+  };
+  readonly yid: {
+    readonly name: "Yiddish";
+    readonly kind: "language";
+    readonly iso639_3: "yid";
+    readonly bcp47: "yi";
+  };
+  readonly yua: {
+    readonly name: "Yucatec Maya";
+    readonly kind: "language";
+    readonly iso639_3: "yua";
+    readonly bcp47: "yua";
+  };
+};
+/**
+ * A language code OCHRE publishes
+ */
+export type OchreLanguageCode = keyof typeof OCHRE_LANGUAGES;
+/**
+ * Check whether a string is a language code OCHRE publishes
+ * @param code - The code to check
+ * @returns Whether OCHRE publishes the code
+ */
+export declare function isOchreLanguageCode(code: string): code is OchreLanguageCode;
+/**
+ * Look up a language OCHRE publishes by its OCHRE code
+ * @param code - The OCHRE language code
+ * @returns The language, or null when OCHRE does not publish the code
+ */
+export declare function getOchreLanguage(code: string): OchreLanguage | null;
+/**
+ * Find the OCHRE code of a language from its ISO 639-3 identifier
+ * @param iso639_3 - The ISO 639-3 identifier
+ * @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