glossarist 0.4.36 → 0.4.38

package/src/models/{pronunciation.js → pronunciation.ts}

@@ -1,7 +1,21 @@
 import { GlossaristModel } from './base.js';
 
+export interface PronunciationJson {
+  content?: string | null;
+  language?: string | null;
+  script?: string | null;
+  system?: string | null;
+  country?: string | null;
+}
+
 export class Pronunciation extends GlossaristModel {
-  constructor(data = {}) {
+  readonly content: string | null;
+  readonly language: string | null;
+  readonly script: string | null;
+  readonly system: string | null;
+  readonly country: string | null;
+
+  constructor(data: PronunciationJson = {}) {
     super();
     this.content = data.content ?? null;
     this.language = data.language ?? null;
@@ -10,8 +24,8 @@ export class Pronunciation extends GlossaristModel {
     this.country = data.country ?? null;
   }
 
-  toJSON() {
-    const obj = {};
+  override toJSON(): PronunciationJson {
+    const obj: PronunciationJson = {};
     if (this.content != null) obj.content = this.content;
     if (this.language != null) obj.language = this.language;
     if (this.script != null) obj.script = this.script;
@@ -20,7 +34,7 @@ export class Pronunciation extends GlossaristModel {
     return obj;
   }
 
-  static fromJSON(data) {
+  static override fromJSON(data: PronunciationJson): Pronunciation {
     return new Pronunciation(data);
   }
 }

package/src/models/sequential-hyperedge.ts

@@ -0,0 +1,70 @@
+// SequentialHyperedge — an ISO 12620 A.6.3 / ISO 704:2022 §5.5.5
+// sequential relation connecting a comprehensive concept to two or
+// more subordinate concepts in an ORDERED sequence (temporal,
+// spatial, causal, developmental).
+//
+// Mirror of PartitiveHyperedge and GenericHyperedge. Member array
+// order IS significant — reversing the array reverses the sequence.
+// Use cases: manufacturing process steps, biological life cycles,
+// software release lifecycles, supply chain stages, geological eras.
+
+import { AbstractHyperedge } from './abstract-hyperedge.js';
+import type { AbstractHyperedgeJson } from './abstract-hyperedge.js';
+import { SequentialMember } from './sequential-member.js';
+import type { SequentialMemberJson } from './sequential-member.js';
+import { HyperedgeRegistry } from './hyperedge-registry.js';
+
+export interface SequentialHyperedgeJson extends AbstractHyperedgeJson {
+  members: ReadonlyArray<SequentialMemberJson | SequentialMember>;
+}
+
+export class SequentialHyperedge extends AbstractHyperedge {
+  // Per-class metadata block — the OCP contract.
+  static wireKey = 'sequential_relations' as const;
+  static typeTag = 'sequential_relation' as const;
+  static rdfType = 'gloss:SequentialRelation' as const;
+  static memberClass = SequentialMember;
+  static v1WireKeys: ReadonlyArray<string> = [];
+  static kindLabel = 'SEQ';
+
+  declare readonly members: ReadonlyArray<SequentialMember>;
+
+  constructor(data: Partial<SequentialHyperedgeJson> = {}) {
+    super({
+      comprehensive: data.comprehensive ?? {},
+      members: data.members ?? [],
+      completeness: data.completeness ?? 'complete',
+      criterion: data.criterion,
+      sources: data.sources,
+      notes: data.notes,
+      status: data.status,
+    });
+    this.members = (Array.isArray(data.members) ? data.members : []).map((m) =>
+      m instanceof SequentialMember ? m : new SequentialMember(m as SequentialMemberJson),
+    );
+  }
+
+  static identityOf(
+    value: {
+      comprehensive?: { source?: string | null; id?: string | null } | null;
+      members?: ReadonlyArray<{ ref?: { source?: string | null; id?: string | null } | null } | null>;
+    } | null | undefined,
+  ): string {
+    const v = value ?? {};
+    const c = v.comprehensive ?? {};
+    // For sequential, member order IS significant — do NOT sort.
+    const memberKeys = (v.members ?? []).map((m) => {
+      const r = m?.ref ?? (m as { source?: string; id?: string } | null) ?? {};
+      return `${r.source ?? ''}:${r.id ?? ''}`;
+    });
+    return `${c.source ?? ''}:${c.id ?? ''}|${memberKeys.join('|')}`;
+  }
+
+  static override fromJSON(data: SequentialHyperedgeJson): SequentialHyperedge {
+    return new SequentialHyperedge(data);
+  }
+}
+
+export default SequentialHyperedge;
+
+HyperedgeRegistry.register(SequentialHyperedge);

package/src/models/{sequential-member.js → sequential-member.ts}

@@ -1,13 +1,16 @@
 // SequentialMember — one member of a SequentialHyperedge. Inherits
 // the MECE shape from HyperedgeMember. Distinct leaf class for type
 // safety. Member array order IS significant for sequential hyperedges.
-//
-// See docs/design/abstract-nary-relation.md (concept-model repo).
 
 import { HyperedgeMember } from './hyperedge-member.js';
+import type { HyperedgeMemberJson } from './hyperedge-member.js';
+
+export type SequentialMemberJson = HyperedgeMemberJson;
 
 export class SequentialMember extends HyperedgeMember {
-  // Inherits all attributes and validations from HyperedgeMember.
+  static override fromJSON(data: SequentialMemberJson): SequentialMember {
+    return new SequentialMember(data);
+  }
 }
 
 export default SequentialMember;

package/src/models/abstract-hyperedge.js

@@ -1,119 +0,0 @@
-// AbstractHyperedge — shared base for directed 1→N hyperedges
-// relations (PartitiveHyperedge, GenericHyperedge, future
-// SequentialRelation, AssociativeRelation).
-//
-// Carries the common shape:
-//   - comprehensive: ConceptRef
-//   - members: 2+ MECE dimensioned concept refs (≥2 per ISO 704)
-//   - completeness: complete | partial
-//   - criterion: localized subdivision criterion (ISO 12620)
-//   - sources / notes / status: administrative metadata
-//
-// Concrete leaves add type-specific fields if needed (currently none).
-// See docs/design/abstract-hyperedge.md (concept-model repo).
-
-import { GlossaristModel } from './base.js';
-import { ConceptRef } from './concept-ref.js';
-import {
-  COMPLETENESS,
-  DEFAULT_COMPLETENESS,
-  isValidCompleteness,
-} from './completeness.js';
-
-export class AbstractHyperedge extends GlossaristModel {
-  constructor(data = {}) {
-    super();
-    this.comprehensive = _ensureComprehensive(data.comprehensive);
-    this.members = _ensureMembers(data.members, this.constructor.name);
-    this.completeness = _resolveCompleteness(data.completeness);
-    this.criterion = _normalizeCriterion(data.criterion);
-    this.sources = Array.isArray(data.sources) ? [...data.sources] : [];
-    this.notes = data.notes ?? null;
-    this.status = data.status ?? null;
-
-    _assertNoSelfLoop(this.comprehensive, this.members);
-  }
-
-  get isComplete() { return this.completeness === COMPLETENESS.COMPLETE; }
-  get isPartial() { return this.completeness === COMPLETENESS.PARTIAL; }
-  get isCoordinate() { return this.members.length >= 2; }
-
-  hasCriterion() { return this.criterion != null; }
-
-  identity() {
-    return this.constructor.identityOf(this);
-  }
-
-  toJSON() {
-    const obj = {
-      comprehensive: this.comprehensive.toJSON(),
-      members: this.members.map(m => m.toJSON()),
-      completeness: this.completeness,
-    };
-    if (this.criterion != null) obj.criterion = { ...this.criterion };
-    if (this.sources.length > 0) obj.sources = [...this.sources];
-    if (this.notes != null) obj.notes = { ...this.notes };
-    if (this.status != null) obj.status = this.status;
-    return obj;
-  }
-}
-
-function _ensureComprehensive(value) {
-  const ref = value instanceof ConceptRef ? value : new ConceptRef(value ?? {});
-  if (!ref.source && !ref.id && !ref.text) {
-    throw new Error(
-      'AbstractHyperedge.comprehensive must be a non-empty ConceptReference ' +
-      '(source, id, or text required)',
-    );
-  }
-  return ref;
-}
-
-function _ensureMembers(values, typeName) {
-  if (!Array.isArray(values)) {
-    throw new Error(
-      `${typeName}.members must be an array (got ${typeof values})`,
-    );
-  }
-  if (values.length < 2) {
-    throw new Error(
-      `${typeName} requires ≥2 partitives (ISO 704); got ${values.length}`,
-    );
-  }
-  return values;
-}
-
-function _resolveCompleteness(value) {
-  const c = value ?? DEFAULT_COMPLETENESS;
-  if (!isValidCompleteness(c)) {
-    throw new Error(
-      `${c === value ? 'completeness' : 'completeness'} has invalid value ${JSON.stringify(value)}`,
-    );
-  }
-  return c;
-}
-
-function _normalizeCriterion(value) {
-  if (value == null) return null;
-  if (typeof value === 'string') {
-    return value.length > 0 ? { default: value } : null;
-  }
-  if (typeof value === 'object') {
-    const entries = Object.entries(value).filter(([, v]) => typeof v === 'string');
-    return entries.length > 0 ? Object.fromEntries(entries) : null;
-  }
-  return null;
-}
-
-function _assertNoSelfLoop(comprehensive, members) {
-  const cKey = `${comprehensive.source ?? ''}:${comprehensive.id ?? ''}`;
-  for (const m of members) {
-    const ref = m.ref;
-    const pKey = `${ref?.source ?? ''}:${ref?.id ?? ''}`;
-    if (pKey === cKey && (ref?.source || ref?.id)) {
-      throw new Error(
-        'Relation.members cannot include the comprehensive (no self-loops)',
-      );
-    }
-  }
-}

package/src/models/bibliography-data.js

@@ -1,48 +0,0 @@
-import * as yaml from 'js-yaml';
-import { GlossaristModel } from './base.js';
-import { BibliographyEntry } from './bibliography-entry.js';
-
-export class BibliographyData extends GlossaristModel {
-  constructor(data = {}) {
-    super();
-    let entriesData;
-    if (Array.isArray(data)) {
-      entriesData = data;
-    } else {
-      entriesData = data?.bibliography ?? data?.entries ?? [];
-    }
-    this._rawEntries = Array.isArray(entriesData) ? entriesData : [];
-    this._entries = null;
-  }
-
-  get entries() {
-    return this._lazy('_entries', '_rawEntries',
-      e => e instanceof BibliographyEntry ? e : new BibliographyEntry(e));
-  }
-
-  find(id) {
-    return this.entries.find(e => e.id === id) ?? null;
-  }
-
-  get keys() {
-    return this.entries.map(e => e.id);
-  }
-
-  toJSON() {
-    if (this.entries.length === 0) return { bibliography: [] };
-    return { bibliography: this.entries.map(e => e.toJSON()) };
-  }
-
-  toYAML() {
-    return yaml.dump(this.toJSON());
-  }
-
-  static fromYAML(yamlString) {
-    const parsed = yaml.load(yamlString);
-    return new BibliographyData(parsed ?? {});
-  }
-
-  static fromJSON(data) {
-    return new BibliographyData(data);
-  }
-}

package/src/models/concept-system.js

@@ -1,117 +0,0 @@
-// ConceptSystem — first-class concept system entity per ISO 12620 A.7.
-//
-// Promotes the previously-implicit concept system (domains + tags +
-// relation graph) to an explicit first-class entity. Per-file at
-// `concept-systems/<id>.yaml`.
-//
-// See docs/design/concept-systems.md (concept-model repo).
-
-import { GlossaristModel } from './base.js';
-import { ConceptRef } from './concept-ref.js';
-import {
-  CONCEPT_SYSTEM_TYPE,
-  CONCEPT_SYSTEM_TYPE_VALUES,
-  isValidConceptSystemType,
-} from './concept-system-type.js';
-
-export class ConceptSystem extends GlossaristModel {
-  constructor(data = {}) {
-    super();
-    this.id = _ensureNonEmptyString(data.id, 'id');
-    this.name = _ensureName(data.name);
-    this.type = _resolveType(data.type);
-    this.domain = data.domain ?? null;
-    this.purpose = data.purpose ?? null;
-    this.members = _ensureMembers(data.members);
-    this.hyperedges = Array.isArray(data.hyperedges) ? [...data.hyperedges] : [];
-    this.rootConcepts = Array.isArray(data.rootConcepts)
-      ? data.rootConcepts.map(c => c instanceof ConceptRef ? c : new ConceptRef(c))
-      : [];
-    this.sources = Array.isArray(data.sources) ? [...data.sources] : [];
-    this.status = data.status ?? null;
-  }
-
-  get isGeneric()     { return this.type === CONCEPT_SYSTEM_TYPE.GENERIC; }
-  get isPartitive()   { return this.type === CONCEPT_SYSTEM_TYPE.PARTITIVE; }
-  get isSequential()  { return this.type === CONCEPT_SYSTEM_TYPE.SEQUENTIAL; }
-  get isAssociative() { return this.type === CONCEPT_SYSTEM_TYPE.ASSOCIATIVE; }
-  get isMixed()       { return this.type === CONCEPT_SYSTEM_TYPE.MIXED; }
-
-  hasHyperedge(edgeId) {
-    return this.hyperedges.includes(edgeId);
-  }
-
-  hasMember(refOrUri) {
-    const uri = typeof refOrUri === 'string' ? refOrUri : _refUri(refOrUri);
-    return this.members.some(m => _refUri(m) === uri);
-  }
-
-  identity() {
-    return this.id;
-  }
-
-  toJSON() {
-    const obj = {
-      id: this.id,
-      name: { ...this.name },
-      type: this.type,
-      members: this.members.map(m => m.toJSON()),
-    };
-    if (this.domain != null) obj.domain = this.domain;
-    if (this.purpose != null) obj.purpose = { ...this.purpose };
-    if (this.hyperedges.length > 0) obj.hyperedges = [...this.hyperedges];
-    if (this.rootConcepts.length > 0) obj.rootConcepts = this.rootConcepts.map(c => c.toJSON());
-    if (this.sources.length > 0) obj.sources = [...this.sources];
-    if (this.status != null) obj.status = this.status;
-    return obj;
-  }
-
-  static fromJSON(data) {
-    return new ConceptSystem(data);
-  }
-}
-
-function _ensureNonEmptyString(value, fieldName) {
-  if (typeof value !== 'string' || value.length === 0) {
-    throw new Error(`ConceptSystem#${fieldName} must be a non-empty string`);
-  }
-  return value;
-}
-
-function _ensureName(value) {
-  if (value == null) return {};
-  if (typeof value !== 'object' || Array.isArray(value)) {
-    throw new Error('ConceptSystem#name must be a localized object (e.g. { eng: "..." })');
-  }
-  return { ...value };
-}
-
-function _resolveType(value) {
-  if (value == null) {
-    throw new Error(
-      'ConceptSystem#type is required; one of ' +
-      CONCEPT_SYSTEM_TYPE_VALUES.join(', '),
-    );
-  }
-  if (!isValidConceptSystemType(value)) {
-    throw new Error(
-      `ConceptSystem#type ${JSON.stringify(value)} invalid; ` +
-      `must be one of: ${CONCEPT_SYSTEM_TYPE_VALUES.join(', ')}`,
-    );
-  }
-  return value;
-}
-
-function _ensureMembers(values) {
-  if (!Array.isArray(values) || values.length === 0) {
-    throw new Error('ConceptSystem#members must be a non-empty array');
-  }
-  return values.map(v => v instanceof ConceptRef ? v : new ConceptRef(v));
-}
-
-function _refUri(ref) {
-  const r = ref?.ref ?? ref ?? {};
-  return `${r.source ?? ''}:${r.id ?? ''}`;
-}
-
-export default ConceptSystem;

package/src/models/detailed-definition.js

@@ -1,59 +0,0 @@
-import { GlossaristModel } from './base.js';
-import { Citation } from './citation.js';
-import { canonicalJson } from '../diff/canonical-json.js';
-
-export class DetailedDefinition extends GlossaristModel {
-  constructor(data = {}) {
-    super();
-    this.content = data.content ?? '';
-    this._rawSources = data.sources ?? [];
-    this._rawExamples = data.examples ?? [];
-    this._sources = null;
-    this._examples = null;
-  }
-
-  get sources() {
-    return this._lazy('_sources', '_rawSources',
-      s => s instanceof Citation ? s : new Citation(s));
-  }
-
-  get examples() {
-    return this._lazy('_examples', '_rawExamples',
-      e => e instanceof DetailedDefinition ? e : new DetailedDefinition(e));
-  }
-
-  toJSON() {
-    const obj = { content: this.content };
-    this._serialize(obj, 'sources', '_sources', '_rawSources');
-    this._serialize(obj, 'examples', '_examples', '_rawExamples');
-    return obj;
-  }
-
-  /**
-   * Yield this definition's content and the content of every nested
-   * example (recursively). Each item carries `{ text, source }` where
-   * `source` is `<path>.content` rooted at the `path` argument.
-   */
-  *walkTexts(path) {
-    if (typeof this.content === 'string' && this.content.length > 0) {
-      yield { text: this.content, source: `${path}.content` };
-    }
-    for (let i = 0; i < this.examples.length; i++) {
-      yield* this.examples[i].walkTexts(`${path}.examples[${i}]`);
-    }
-  }
-
-  static identityOf(value) {
-    if (value == null) return '';
-    if (typeof value.toJSON === 'function') return canonicalJson(value.toJSON());
-    return canonicalJson(value);
-  }
-
-  identity() {
-    return DetailedDefinition.identityOf(this);
-  }
-
-  static fromJSON(data) {
-    return new DetailedDefinition(data);
-  }
-}

package/src/models/generic-hyperedge.js

@@ -1,55 +0,0 @@
-// GenericHyperedge — an ISO 704 / ISO 1087-1 / ISO 12620 generic
-// relation connecting a comprehensive concept (the genus) to two
-// or more specific concepts (the species) which together constitute
-// a decomposition by some criterion of subdivision.
-//
-// Mirror of PartitiveHyperedge. Multiple GenericRelations on the same
-// comprehensive distinguished by `criterion` is the OIML pattern
-// (5.1 measurement standard has 6 criterion groups).
-//
-// See docs/design/generic-relation.md (concept-model repo).
-
-import { AbstractHyperedge } from './abstract-hyperedge.js';
-import { GenericMember } from './generic-member.js';
-import { HyperedgeRegistry } from './hyperedge-registry.js';
-
-export class GenericHyperedge extends AbstractHyperedge {
-  // Per-class metadata block — the OCP contract. See PartitiveHyperedge
-  // for field documentation.
-  static wireKey     = 'generic_relations';
-  static typeTag     = 'generic_relation';
-  static rdfType     = 'gloss:GenericRelation';
-  static memberClass = GenericMember;
-  static v1WireKeys  = [];
-  static kindLabel   = 'GEN';
-
-  constructor(data = {}) {
-    super(data);
-    this.members = data?.members == null
-      ? this.members
-      : (Array.isArray(data.members)
-          ? data.members.map(m =>
-              m instanceof GenericMember ? m : new GenericMember(m))
-          : this.members);
-  }
-
-  static identityOf(value) {
-    const v = value ?? {};
-    const c = v.comprehensive ?? {};
-    const memberKeys = Array.isArray(v.members)
-      ? v.members.map(m => {
-          const r = m?.ref ?? m ?? {};
-          return `${r.source ?? ''}:${r.id ?? ''}`;
-        }).sort()
-      : [];
-    return `${c.source ?? ''}:${c.id ?? ''}|${memberKeys.join('|')}`;
-  }
-
-  static fromJSON(data) {
-    return new GenericHyperedge(data);
-  }
-}
-
-export default GenericHyperedge;
-
-HyperedgeRegistry.register(GenericHyperedge);

package/src/models/generic-member.js

@@ -1,82 +0,0 @@
-// GenericMember — one member of a GenericHyperedge.
-//
-// Per ISO 704:2022 §5.5.4.2.1 (Generic relations and general concepts):
-//
-//   "In a generic relation, the intension of the subordinate concept
-//    includes the intension of the superordinate concept plus at least
-//    one additional delimiting characteristic."
-//
-// In hyperedge terms: when a GenericHyperedge has comprehensive=computer mouse
-// and criterion=means of movement detection, each member (mechanical mouse,
-// optomechanical mouse, optical mouse) carries a delimitingCharacteristic —
-// the value of the criterion for that specific concept:
-//
-//   mechanical mouse     → 'detecting movement by means of rollers'
-//   optomechanical mouse → 'detecting movement by means of rollers and light sensors'
-//   optical mouse        → 'detecting movement by means of light sensors'
-//
-// Multidimensionality (§5.6.3): the same comprehensive can be the
-// '1' side of multiple generic hyperedges simultaneously, each by a
-// different criterion. computer mouse is also comprehensive of
-// {wired mouse, wireless mouse} under criterion=computer connection.
-// That second hyperedge's members carry their own delimitingCharacteristic
-// values ('using a corded electrical connection', 'using a cordless
-// light or sound connection').
-//
-// delimitingCharacteristic is REQUIRED on GenericMember. Without it,
-// the member is just a coordinate concept with no semantic content
-// tying it to the criterion — ISO 704 says the relation is meaningless
-// without the delimiting characteristic.
-//
-// LocalizedString shape (mirrors criterion on the parent hyperedge):
-//   { eng: 'detecting movement by means of light sensors' }
-//   { eng: '...', fra: '...' }   — multiple languages supported
-
-import { HyperedgeMember } from './hyperedge-member.js';
-
-export class GenericMember extends HyperedgeMember {
-  constructor(data = {}) {
-    super(data);
-    this.delimitingCharacteristic = _resolveDelimitingCharacteristic(data.delimitingCharacteristic);
-  }
-
-  toJSON() {
-    const base = super.toJSON();
-    base.delimitingCharacteristic = { ...this.delimitingCharacteristic };
-    return base;
-  }
-}
-
-function _resolveDelimitingCharacteristic(value) {
-  if (value == null) {
-    throw new Error(
-      'GenericMember.delimitingCharacteristic is required per ISO 704:2022 §5.5.4.2.1 ' +
-      '(the intension of a subordinate concept must include at least one additional ' +
-      'delimiting characteristic beyond the superordinate).',
-    );
-  }
-  if (typeof value === 'string') {
-    if (value.length === 0) {
-      throw new Error(
-        'GenericMember.delimitingCharacteristic cannot be empty (ISO 704:2022 §5.5.4.2.1)',
-      );
-    }
-    return { default: value };
-  }
-  if (typeof value === 'object') {
-    const entries = Object.entries(value).filter(([, v]) => typeof v === 'string' && v.length > 0);
-    if (entries.length === 0) {
-      throw new Error(
-        'GenericMember.delimitingCharacteristic must have at least one non-empty string ' +
-        'value (ISO 704:2022 §5.5.4.2.1)',
-      );
-    }
-    return Object.fromEntries(entries);
-  }
-  throw new Error(
-    `GenericMember.delimitingCharacteristic must be a string or a language-keyed object; ` +
-    `got ${typeof value}`,
-  );
-}
-
-export default GenericMember;

package/src/models/grammar-info.js

@@ -1,40 +0,0 @@
-import { GlossaristModel } from './base.js';
-
-export const GRAMMAR_GENDERS = Object.freeze(['m', 'f', 'n', 'c']);
-export const GRAMMAR_NUMBERS = Object.freeze(['singular', 'dual', 'plural']);
-export const GRAMMAR_PARTS_OF_SPEECH = Object.freeze([
-  'noun', 'verb', 'adj', 'adverb', 'preposition', 'participle',
-]);
-
-export class GrammarInfo extends GlossaristModel {
-  constructor(data = {}) {
-    super();
-    this.gender = data.gender ?? null;
-    this.number = data.number ?? null;
-    this.partOfSpeech = data.part_of_speech ?? data.partOfSpeech ?? null;
-    this.noun = data.noun ?? false;
-    this.verb = data.verb ?? false;
-    this.adj = data.adj ?? false;
-    this.adverb = data.adverb ?? false;
-    this.preposition = data.preposition ?? false;
-    this.participle = data.participle ?? false;
-  }
-
-  toJSON() {
-    const obj = {};
-    if (this.gender != null) obj.gender = this.gender;
-    if (this.number != null) obj.number = this.number;
-    if (this.partOfSpeech != null) obj.part_of_speech = this.partOfSpeech;
-    if (this.noun) obj.noun = true;
-    if (this.verb) obj.verb = true;
-    if (this.adj) obj.adj = true;
-    if (this.adverb) obj.adverb = true;
-    if (this.preposition) obj.preposition = true;
-    if (this.participle) obj.participle = true;
-    return obj;
-  }
-
-  static fromJSON(data) {
-    return new GrammarInfo(data);
-  }
-}

package/src/models/localized-string.js

@@ -1,19 +0,0 @@
-const FALLBACK_LANG = 'eng';
-
-export function fetchLocalizedString(hash, lang, fallback = FALLBACK_LANG) {
-  if (hash == null || typeof hash !== 'object') return null;
-  const direct = hash[lang] ?? hash[String(lang)];
-  if (direct != null) return direct;
-  if (fallback != null && fallback !== lang) {
-    return hash[fallback] ?? hash[String(fallback)] ?? null;
-  }
-  return null;
-}
-
-export function localizedStringIsEmpty(hash) {
-  return hash == null || (typeof hash === 'object' && Object.keys(hash).length === 0);
-}
-
-export function localizedStringIsPresent(hash) {
-  return !localizedStringIsEmpty(hash);
-}