glossarist 0.4.39 → 0.4.40

package/src/models/designation.js

@@ -1,213 +0,0 @@
-import { RegistrableModel } from './registrable.js';
-import { ConceptSource } from './concept-source.js';
-import { Pronunciation } from './pronunciation.js';
-import { GrammarInfo } from './grammar-info.js';
-import { RelatedConcept } from './related-concept.js';
-import { DesignationRelationship, DESIGNATION_RELATIONSHIP_TYPES } from './designation-relationship.js';
-
-// Maps a normative-status local-name to the matching SKOS/SKOS-XL label
-// predicate local-name. Lives on the model so a new status requires a
-// single edit here, not edits in every emitter.
-const SKOS_LABEL_BY_NORMATIVE_STATUS = Object.freeze({
-  preferred: 'prefLabel',
-  deprecated: 'hiddenLabel',
-  admitted: 'altLabel',
-  deprecated_: 'altLabel',
-});
-
-export class Designation extends RegistrableModel {
-  constructor(data = {}) {
-    super();
-    this.designation = data.designation ?? '';
-    this.type = data.type ?? 'expression';
-    this.normativeStatus = data.normative_status ?? null;
-    this.absent = data.absent ?? null;
-    this.fieldOfApplication = data.field_of_application ?? null;
-    this.usageInfo = data.usage_info ?? null;
-    this.geographicalArea = data.geographical_area ?? null;
-    this.language = data.language ?? null;
-    this.script = data.script ?? null;
-    this.system = data.system ?? null;
-    this.international = data.international ?? null;
-    this.termType = data.term_type ?? null;
-    this.pronunciations = (data.pronunciation ?? []).map(
-      p => p instanceof Pronunciation ? p : new Pronunciation(p)
-    );
-    this.sources = (data.sources ?? []).map(
-      s => s instanceof ConceptSource ? s : new ConceptSource(s)
-    );
-    this.related = (data.related ?? []).map(
-      r => (r instanceof DesignationRelationship || r instanceof RelatedConcept)
-        ? r
-        : DESIGNATION_RELATIONSHIP_TYPES.includes(r.type)
-          ? DesignationRelationship.fromJSON(r)
-          : RelatedConcept.fromJSON(r)
-    );
-  }
-
-  toJSON() {
-    const obj = { type: this.type, designation: this.designation };
-    if (this.normativeStatus != null) obj.normative_status = this.normativeStatus;
-    if (this.absent != null) obj.absent = this.absent;
-    if (this.fieldOfApplication != null) obj.field_of_application = this.fieldOfApplication;
-    if (this.usageInfo != null) obj.usage_info = this.usageInfo;
-    if (this.geographicalArea != null) obj.geographical_area = this.geographicalArea;
-    if (this.language != null) obj.language = this.language;
-    if (this.script != null) obj.script = this.script;
-    if (this.system != null) obj.system = this.system;
-    if (this.international != null) obj.international = this.international;
-    if (this.termType != null) obj.term_type = this.termType;
-    if (this.pronunciations.length > 0) obj.pronunciation = this.pronunciations.map(p => p.toJSON());
-    if (this.sources.length > 0) obj.sources = this.sources.map(s => s.toJSON());
-    if (this.related.length > 0) obj.related = this.related.map(r => r.toJSON());
-    return obj;
-  }
-
-  // RDF class local-name for this designation subtype. Override in
-  // subclasses that map to a different ontology class.
-  rdfClass() {
-    return 'Expression';
-  }
-
-  // SKOS label predicate URI (skos:prefLabel / skos:altLabel / skos:hiddenLabel)
-  // appropriate for this designation's normative status. Falls back to
-  // skos:altLabel for unknown statuses.
-  skosLabelPredicate(skosNs) {
-    const label = this._skosLabelLocalName();
-    return `${skosNs}${label}`;
-  }
-
-  // SKOS-XL label predicate URI (skosxl:prefLabel / etc.).
-  skosxlLabelPredicate(skosxlNs) {
-    const label = this._skosLabelLocalName();
-    return `${skosxlNs}${label}`;
-  }
-
-  _skosLabelLocalName() {
-    const status = String(this.normativeStatus ?? '')
-      .split(/[/#]/)
-      .pop()
-      .trim();
-    return SKOS_LABEL_BY_NORMATIVE_STATUS[status] ?? 'altLabel';
-  }
-
-  // Static identity works on a model instance OR its plain JSON form.
-  // The diff layer uses this so that patch-side identity (computed on
-  // plain JSON from toJSON) matches diff-side identity (computed on
-  // model instances).
-  static identityOf(value) {
-    const v = value ?? {};
-    const type = v.type ?? 'expression';
-    const text = String(v.designation ?? '').toLowerCase().trim();
-    return `${type}|${text}`;
-  }
-
-  identity() {
-    return Designation.identityOf(this);
-  }
-
-  static fromJSON(data) {
-    return Designation.fromData(data);
-  }
-}
-
-export class Expression extends Designation {
-  constructor(data = {}) {
-    super(data);
-    this.prefix = data.prefix ?? null;
-    this.grammarInfo = (data.grammar_info ?? []).map(
-      g => g instanceof GrammarInfo ? g : new GrammarInfo(g)
-    );
-  }
-
-  toJSON() {
-    const obj = super.toJSON();
-    if (this.prefix != null) obj.prefix = this.prefix;
-    if (this.grammarInfo.length > 0) obj.grammar_info = this.grammarInfo.map(g => g.toJSON());
-    return obj;
-  }
-
-  static fromJSON(data) { return new Expression(data); }
-}
-
-Designation.register('expression', Expression);
-
-export class Abbreviation extends Expression {
-  constructor(data = {}) {
-    super(data);
-    this.acronym = data.acronym ?? false;
-    this.initialism = data.initialism ?? false;
-    this.truncation = data.truncation ?? false;
-  }
-
-  rdfClass() {
-    return 'Abbreviation';
-  }
-
-  toJSON() {
-    const obj = super.toJSON();
-    if (this.acronym) obj.acronym = true;
-    if (this.initialism) obj.initialism = true;
-    if (this.truncation) obj.truncation = true;
-    return obj;
-  }
-
-  static fromJSON(data) { return new Abbreviation(data); }
-}
-
-Designation.register('abbreviation', Abbreviation);
-
-export class Symbol extends Designation {
-  rdfClass() {
-    return 'Symbol';
-  }
-
-  static fromJSON(data) { return new Symbol(data); }
-}
-
-Designation.register('symbol', Symbol);
-
-export class LetterSymbol extends Symbol {
-  constructor(data = {}) {
-    super(data);
-    this.text = data.text ?? null;
-  }
-
-  rdfClass() {
-    return 'LetterSymbol';
-  }
-
-  toJSON() {
-    const obj = super.toJSON();
-    if (this.text != null) obj.text = this.text;
-    return obj;
-  }
-
-  static fromJSON(data) { return new LetterSymbol(data); }
-}
-
-Designation.register('letter_symbol', LetterSymbol);
-
-export class GraphicalSymbol extends Symbol {
-  constructor(data = {}) {
-    super(data);
-    this.text = data.text ?? null;
-    this.image = data.image ?? null;
-  }
-
-  rdfClass() {
-    return 'GraphicalSymbol';
-  }
-
-  toJSON() {
-    const obj = super.toJSON();
-    if (this.text != null) obj.text = this.text;
-    if (this.image != null) obj.image = this.image;
-    return obj;
-  }
-
-  static fromJSON(data) { return new GraphicalSymbol(data); }
-}
-
-Designation.register('graphical symbol', GraphicalSymbol);
-Designation.register('graphical_symbol', GraphicalSymbol);

package/src/models/gcr-metadata.js

@@ -1,68 +0,0 @@
-import * as yaml from 'js-yaml';
-import { GlossaristModel } from './base.js';
-import { GcrStatistics } from './gcr-statistics.js';
-
-export class GcrMetadata extends GlossaristModel {
-  constructor(data = {}) {
-    super();
-    this.shortname = data.shortname ?? null;
-    this.version = data.version ?? null;
-    this.title = data.title ?? null;
-    this.description = data.description ?? null;
-    this.owner = data.owner ?? null;
-    this.tags = data.tags ?? [];
-    this.conceptCount = data.concept_count ?? data.conceptCount ?? 0;
-    this.languages = data.languages ?? [];
-    this.createdAt = data.created_at ?? data.createdAt ?? null;
-    this.glossaristVersion = data.glossarist_version ?? data.glossaristVersion ?? null;
-    this.schemaVersion = data.schema_version ?? data.schemaVersion ?? '1';
-    this.homepage = data.homepage ?? null;
-    this.repository = data.repository ?? null;
-    this.license = data.license ?? null;
-    this.uriPrefix = data.uri_prefix ?? data.uriPrefix ?? null;
-    this.conceptUriTemplate = data.concept_uri_template ?? data.conceptUriTemplate ?? null;
-    this.compiledFormats = data.compiled_formats ?? data.compiledFormats ?? [];
-    this.statistics = data.statistics
-      ? (data.statistics instanceof GcrStatistics ? data.statistics : new GcrStatistics(data.statistics))
-      : null;
-  }
-
-  get concept_count() { return this.conceptCount; }
-  get created_at() { return this.createdAt; }
-  get glossarist_version() { return this.glossaristVersion; }
-  get schema_version() { return this.schemaVersion; }
-  get uri_prefix() { return this.uriPrefix; }
-  get concept_uri_template() { return this.conceptUriTemplate; }
-  get compiled_formats() { return this.compiledFormats; }
-
-  toJSON() {
-    const obj = {};
-    if (this.shortname != null) obj.shortname = this.shortname;
-    if (this.version != null) obj.version = this.version;
-    if (this.title != null) obj.title = this.title;
-    if (this.description != null) obj.description = this.description;
-    if (this.owner != null) obj.owner = this.owner;
-    if (this.tags.length > 0) obj.tags = this.tags;
-    if (this.conceptCount > 0) obj.concept_count = this.conceptCount;
-    if (this.languages.length > 0) obj.languages = this.languages;
-    if (this.createdAt != null) obj.created_at = this.createdAt;
-    if (this.glossaristVersion != null) obj.glossarist_version = this.glossaristVersion;
-    if (this.schemaVersion != null) obj.schema_version = this.schemaVersion;
-    if (this.homepage != null) obj.homepage = this.homepage;
-    if (this.repository != null) obj.repository = this.repository;
-    if (this.license != null) obj.license = this.license;
-    if (this.uriPrefix != null) obj.uri_prefix = this.uriPrefix;
-    if (this.conceptUriTemplate != null) obj.concept_uri_template = this.conceptUriTemplate;
-    if (this.compiledFormats.length > 0) obj.compiled_formats = this.compiledFormats;
-    if (this.statistics != null) obj.statistics = this.statistics.toJSON();
-    return obj;
-  }
-
-  static fromJSON(data) {
-    return new GcrMetadata(data);
-  }
-
-  static fromYaml(yamlString) {
-    return new GcrMetadata(yaml.load(yamlString));
-  }
-}

package/src/models/gcr-statistics.js

@@ -1,51 +0,0 @@
-import { GlossaristModel } from './base.js';
-
-export class GcrStatistics extends GlossaristModel {
-  constructor(data = {}) {
-    super();
-    this.totalConcepts = data.total_concepts ?? data.totalConcepts ?? 0;
-    this.conceptsWithDefinitions = data.concepts_with_definitions ?? data.conceptsWithDefinitions ?? 0;
-    this.conceptsByStatus = data.concepts_by_status ?? data.conceptsByStatus ?? {};
-  }
-
-  get total_concepts() { return this.totalConcepts; }
-  get concepts_with_definitions() { return this.conceptsWithDefinitions; }
-  get concepts_by_status() { return this.conceptsByStatus; }
-
-  toJSON() {
-    const obj = { total_concepts: this.totalConcepts };
-    if (this.conceptsWithDefinitions > 0) {
-      obj.concepts_with_definitions = this.conceptsWithDefinitions;
-    }
-    if (Object.keys(this.conceptsByStatus).length > 0) {
-      obj.concepts_by_status = this.conceptsByStatus;
-    }
-    return obj;
-  }
-
-  static fromJSON(data) {
-    return new GcrStatistics(data);
-  }
-
-  static fromConcepts(concepts) {
-    const langs = new Set();
-    let withDefs = 0;
-    const byStatus = {};
-
-    for (const concept of concepts) {
-      for (const lang of concept.languages) {
-        langs.add(lang);
-        const lc = concept.localization(lang);
-        if (lc && lc.definitions.length > 0) withDefs++;
-        const status = lc?.entryStatus ?? 'unknown';
-        byStatus[status] = (byStatus[status] ?? 0) + 1;
-      }
-    }
-
-    return new GcrStatistics({
-      total_concepts: concepts.length,
-      concepts_with_definitions: withDefs,
-      concepts_by_status: byStatus,
-    });
-  }
-}

package/src/models/hyperedge-colors.js

@@ -1,71 +0,0 @@
-// Hyperedge color resolver — resolves display colors for a
-// PartitiveHyperedge based on its enumeration and the carrying
-// concept's category color.
-//
-// Closed hyperedges render at full intensity (the relationship is
-// definitive — these are ALL the parts). Open hyperedges render at
-// reduced intensity (the relationship is partial — other parts may
-// exist).
-//
-// Marker-based styling (double = thicker stroke, dashed = dashed
-// pattern) is the caller's responsibility; this resolver returns
-// the color only, plus a `pattern` hint for marker-based styling.
-
-import { categoryColorPair } from './relation-colors.js';
-
-const ENUMERATION_INTENSITY = Object.freeze({
-  closed: 1.0,
-  open: 0.55,
-});
-
-const DEFAULT_CATEGORY = 'hierarchical';
-
-export function resolveHyperedgeColor(hyperedge, options = {}) {
-  if (!hyperedge) return null;
-
-  const category = options.category ?? DEFAULT_CATEGORY;
-  const base = categoryColorPair(category, options.overrides);
-  if (!base) return null;
-
-  const intensity = ENUMERATION_INTENSITY[hyperedge.enumeration] ?? 1.0;
-  const pattern = derivePattern(hyperedge.markers);
-
-  return {
-    light: tint(base.light, intensity),
-    dark: tint(base.dark, intensity),
-    pattern,
-  };
-}
-
-function derivePattern(markers) {
-  const arr = markers ?? [];
-  if (arr.includes('dashed')) return 'dashed';
-  if (arr.includes('double')) return 'double';
-  return null;
-}
-
-// Linear interpolation between the base color and white (light mode)
-// or between the base and a neutral (dark mode). Pure-string inputs
-// return the original color when intensity === 1.0.
-function tint(hex, ratio) {
-  if (ratio >= 1.0) return hex;
-  const rgb = parseHex(hex);
-  if (!rgb) return hex;
-
-  const target = [255, 255, 255];
-  const mixed = rgb.map((c, i) =>
-    Math.round(c + (target[i] - c) * (1 - ratio)));
-  return '#' + mixed.map(c => c.toString(16).padStart(2, '0')).join('');
-}
-
-function parseHex(s) {
-  if (typeof s !== 'string') return null;
-  const m = s.match(/^#?([0-9a-f]{6})$/i);
-  if (!m) return null;
-  const n = m[1];
-  return [
-    parseInt(n.slice(0, 2), 16),
-    parseInt(n.slice(2, 4), 16),
-    parseInt(n.slice(4, 6), 16),
-  ];
-}

package/src/models/register.js

@@ -1,253 +0,0 @@
-import { GlossaristModel } from './base.js';
-import { Section } from './section.js';
-import { resolveColor } from './dataset-color.js';
-
-export const REGISTER_STATUSES = Object.freeze([
-  'current',
-  'superseded',
-  'withdrawn',
-  'draft',
-]);
-
-export class Register extends GlossaristModel {
-  constructor(data = {}) {
-    super();
-    this.schemaVersion = data.schema_version ?? data.schemaVersion ?? '3';
-    this.id = data.id ?? null;
-    this.name = data.name ?? null;
-    this.ref = data.ref ?? null;
-    this.refAliases = data.refAliases ?? data.ref_aliases ?? [];
-    this.year = data.year ?? null;
-    this.urn = data.urn ?? null;
-    this.urnAliases = data.urnAliases ?? data.urn_aliases ?? [];
-    this.status = data.status ?? null;
-    this.supersedes = data.supersedes ?? null;
-    this.owner = data.owner ?? null;
-    this.sourceRepo = data.sourceRepo ?? data.source_repo ?? null;
-    this.tags = data.tags ?? [];
-    this.languages = data.languages ?? [];
-    this.languageOrder = data.languageOrder ?? data.language_order ?? [];
-    this.ordering = data.ordering ?? null;
-    this.logo = data.logo ?? null;
-    this.color = data.color ?? null;
-    this.description = data.description ?? {};
-    this.about = data.about ?? {};
-    this.provenance = data.provenance ?? [];
-    this.contributors = data.contributors ?? [];
-    this.sections = (data.sections ?? []).map(s =>
-      s instanceof Section ? s : new Section(s)
-    );
-    this._raw = this._extractRaw(data);
-  }
-
-  _extractRaw(data) {
-    const known = new Set([
-      'schema_version', 'schemaVersion',
-      'id', 'name', 'ref', 'refAliases', 'ref_aliases',
-      'year', 'urn', 'urnAliases', 'urn_aliases',
-      'status', 'supersedes', 'owner',
-      'sourceRepo', 'source_repo', 'tags',
-      'languages', 'languageOrder', 'language_order',
-      'ordering', 'logo', 'color', 'description', 'about',
-      'provenance', 'contributors', 'sections',
-    ]);
-    const extra = {};
-    for (const [k, v] of Object.entries(data)) {
-      if (!known.has(k)) extra[k] = v;
-    }
-    return extra;
-  }
-
-  sectionById(id) {
-    for (const section of this.sections) {
-      if (section.id === id) return section;
-      const found = section.descendantById(id);
-      if (found) return found;
-    }
-    return null;
-  }
-
-  // Walks the section tree upward from `sectionId`, returning the
-  // ancestor chain in immediate-parent-first order. The returned array
-  // does NOT include sectionId itself. Returns [] when sectionId is
-  // unknown or is a top-level section.
-  //
-  // Mirrors glossarist-ruby's section-cascading walk (commit 43dca6b)
-  // and the ontology's owl:TransitiveProperty declaration on
-  // gloss:hasParentSection.
-  sectionAncestorIds(sectionId) {
-    if (!sectionId) return [];
-    for (const root of this.sections) {
-      const chain = _ancestorChain(root, sectionId);
-      if (chain) return chain;
-    }
-    return [];
-  }
-
-  // Returns the closure of `sectionId`: the section plus all of its
-  // ancestors. Concept-section membership tests should intersect the
-  // concept's section list with this closure so a concept in section
-  // "3.1.1" matches a filter on "3.1" or "3".
-  sectionClosure(sectionId) {
-    return [sectionId, ...this.sectionAncestorIds(sectionId)];
-  }
-
-  // Walks the section tree DOWNWARD from `sectionId`, returning all
-  // descendant section IDs in pre-order (immediate children first,
-  // then their children). The returned array does NOT include
-  // sectionId itself. Returns [] when sectionId is unknown or is a
-  // leaf section. Useful for filtering concepts by parent section
-  // (include descendants) — the inverse direction of sectionClosure.
-  sectionDescendantIds(sectionId) {
-    if (!sectionId) return [];
-    const section = this.sectionById(sectionId);
-    if (!section) return [];
-    const out = [];
-    for (const child of section.children ?? []) {
-      out.push(child.id);
-      out.push(...this.sectionDescendantIds(child.id));
-    }
-    return out;
-  }
-
-  // Returns the descendant closure of `sectionId`: the section plus
-  // all of its descendants. Useful for "show me everything in section
-  // X or below" queries.
-  sectionDescendantClosure(sectionId) {
-    return [sectionId, ...this.sectionDescendantIds(sectionId)];
-  }
-
-  // Returns all section IDs the concept belongs to: the concept's own
-  // sections plus every ancestor of each. Concept-side section
-  // membership comes from `concept.sections` if set, otherwise from
-  // `concept.groups` (a flat list of section IDs as strings).
-  //
-  // Returns the union (deduped) so callers can do a single
-  // intersection test.
-  conceptSectionIds(concept) {
-    const own = conceptSectionIdList(concept);
-    if (own.length === 0) return [];
-    const closure = new Set();
-    for (const id of own) {
-      for (const ancestor of this.sectionClosure(id)) closure.add(ancestor);
-    }
-    return [...closure];
-  }
-
-  sectionName(sectionId, lang) {
-    const section = this.sectionById(sectionId);
-    return section ? section.name(lang) : null;
-  }
-
-  // Localized display name. Returns the best-matching name string for
-  // the requested language, falling back to English, then to the first
-  // available language, then to null. Accepts three input shapes:
-  //   - null/undefined  → null
-  //   - string          → returned as-is for every language
-  //   - { eng, fra, ... } → language-resolved
-  displayName(lang) {
-    if (this.name == null) return null;
-    if (typeof this.name === 'string') return this.name;
-    if (typeof this.name === 'object') {
-      return this.name[lang]
-        ?? this.name.eng
-        ?? Object.values(this.name)[0]
-        ?? null;
-    }
-    return null;
-  }
-
-  // Returns the hex color for the requested UI mode, falling back to
-  // the single hex when the spec is a string. Returns null when no
-  // color is set or when the requested mode is missing.
-  resolvedColor(mode) {
-    return resolveColor(this.color, mode);
-  }
-
-  toJSON() {
-    const obj = { ...this._raw, schema_version: this.schemaVersion };
-    if (this.id != null) obj.id = this.id;
-    if (this.name != null) obj.name = this.name;
-    if (this.ref != null) obj.ref = this.ref;
-    if (this.refAliases.length > 0) obj.refAliases = [...this.refAliases];
-    if (this.year != null) obj.year = this.year;
-    if (this.urn != null) obj.urn = this.urn;
-    if (this.urnAliases.length > 0) obj.urnAliases = [...this.urnAliases];
-    if (this.status != null) obj.status = this.status;
-    if (this.supersedes != null) obj.supersedes = this.supersedes;
-    if (this.owner != null) obj.owner = this.owner;
-    if (this.sourceRepo != null) obj.sourceRepo = this.sourceRepo;
-    if (this.tags.length > 0) obj.tags = [...this.tags];
-    if (this.languages.length > 0) obj.languages = [...this.languages];
-    if (this.languageOrder.length > 0) obj.languageOrder = [...this.languageOrder];
-    if (this.ordering != null) obj.ordering = this.ordering;
-    if (this.logo != null) obj.logo = { ...this.logo };
-    if (this.color != null) {
-      obj.color = (typeof this.color === 'object' && this.color !== null)
-        ? { ...this.color }
-        : this.color;
-    }
-    if (Object.keys(this.description).length > 0) obj.description = { ...this.description };
-    if (Object.keys(this.about).length > 0) obj.about = { ...this.about };
-    if (this.provenance.length > 0) obj.provenance = this.provenance.map(p => ({ ...p }));
-    if (this.contributors.length > 0) obj.contributors = this.contributors.map(c => ({ ...c }));
-    if (this.sections.length > 0) obj.sections = this.sections.map(s => s.toJSON());
-    return obj;
-  }
-
-  static fromJSON(data) {
-    const instance = new Register(data);
-    const snakeToCamel = k => k.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
-    return new Proxy(instance, {
-      get(target, prop) {
-        if (prop in target) return target[prop];
-        if (prop in target._raw) return target._raw[prop];
-        const camel = snakeToCamel(prop);
-        if (camel in target) return target[camel];
-        return undefined;
-      },
-    });
-  }
-}
-
-// Recursive walk: returns the ancestor chain of `targetId` within the
-// subtree rooted at `section`, or null if targetId is not in this
-// subtree. The chain is immediate-parent-first; the section itself is
-// not included. Built root-first, then reversed for the documented order.
-function _ancestorChain(section, targetId, ancestors = []) {
-  if (section.id === targetId) return [...ancestors].reverse();
-  for (const child of section.children) {
-    const found = _ancestorChain(child, targetId, [...ancestors, section.id]);
-    if (found) return found;
-  }
-  return null;
-}
-
-// Returns the list of section IDs a concept claims membership in.
-// Concepts may carry section IDs via either `sections` (preferred) or
-// `groups` (legacy). Each entry may be a string or an object with an
-// `id` field; both forms are flattened to a string list.
-function conceptSectionIdList(concept) {
-  if (!concept) return [];
-  const fromSections = concept.sections
-    ? _flattenSectionIds(concept.sections)
-    : [];
-  const fromGroups = concept.groups
-    ? _flattenSectionIds(concept.groups)
-    : [];
-  return [...fromSections, ...fromGroups];
-}
-
-function _flattenSectionIds(value) {
-  if (!Array.isArray(value)) return [];
-  const out = [];
-  for (const entry of value) {
-    if (typeof entry === 'string') {
-      out.push(entry);
-    } else if (entry && typeof entry === 'object') {
-      const id = entry.id ?? entry.sectionId ?? entry.ref?.id;
-      if (id) out.push(String(id));
-    }
-  }
-  return out;
-}