glossarist 0.4.39 → 0.4.41

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/localized-concept.js

@@ -1,187 +0,0 @@
-import { GlossaristModel } from './base.js';
-import { Designation } from './designation.js';
-import { DetailedDefinition } from './detailed-definition.js';
-import { ConceptSource } from './concept-source.js';
-import { ConceptDate } from './concept-date.js';
-import { NonVerbRep } from './non-verb-rep.js';
-import { RelatedConcept } from './related-concept.js';
-
-function wrapAs(Cls) {
-  return item => item instanceof Cls ? item : new Cls(item);
-}
-
-const LOC_WIRE_NAMES = Object.freeze({
-  entryStatus: 'entry_status',
-  reviewType: 'review_type',
-  lineageSourceSimilarity: 'lineage_source_similarity',
-  reviewDate: 'review_date',
-  reviewDecisionDate: 'review_decision_date',
-  reviewDecisionEvent: 'review_decision_event',
-  reviewStatus: 'review_status',
-  reviewDecision: 'review_decision',
-  reviewDecisionNotes: 'review_decision_notes',
-});
-
-export class LocalizedConcept extends GlossaristModel {
-  // Scalar metadata fields the diff layer tracks per localization.
-  // Adding a new scalar field requires only appending its name here;
-  // diff/patch/similarity pick it up automatically.
-  // (Invariant N2 — TODO.hyperedges-v2/07.)
-  static get DIFF_FIELDS() {
-    return Object.freeze([
-      'entryStatus', 'classification', 'reviewType', 'domain', 'release',
-      'lineageSourceSimilarity', 'script', 'system',
-      'reviewDate', 'reviewDecisionDate', 'reviewDecisionEvent',
-      'reviewStatus', 'reviewDecision', 'reviewDecisionNotes',
-    ]);
-  }
-
-  static wireNameFor(field) {
-    return LOC_WIRE_NAMES[field] ?? field;
-  }
-
-  constructor(data = {}) {
-    super();
-    this.languageCode = data.language_code ?? data.languageCode ?? null;
-    this.script = data.script ?? null;
-    this.system = data.system ?? null;
-    this.entryStatus = data.entry_status ?? data.entryStatus ?? null;
-    this.classification = data.classification ?? null;
-    this.reviewType = data.review_type ?? data.reviewType ?? null;
-    this.domain = data.domain ?? null;
-    this.release = data.release ?? null;
-    this.lineageSourceSimilarity = data.lineage_source_similarity ?? data.lineageSourceSimilarity ?? null;
-
-    this.reviewDate = data.review_date ?? data.reviewDate ?? null;
-    this.reviewDecisionDate = data.review_decision_date ?? data.reviewDecisionDate ?? null;
-    this.reviewDecisionEvent = data.review_decision_event ?? data.reviewDecisionEvent ?? null;
-    this.reviewStatus = data.review_status ?? data.reviewStatus ?? null;
-    this.reviewDecision = data.review_decision ?? data.reviewDecision ?? null;
-    this.reviewDecisionNotes = data.review_decision_notes ?? data.reviewDecisionNotes ?? null;
-
-    this._rawTerms = data.terms ?? [];
-    this._rawDefinition = data.definition ?? [];
-    this._rawSources = data.sources ?? [];
-    this._rawNotes = data.notes ?? [];
-    this._rawAnnotations = data.annotations ?? [];
-    this._rawExamples = data.examples ?? [];
-    this._rawDates = data.dates ?? [];
-    this._rawNonVerbal = data.non_verbal_rep ?? data.non_verb ?? [];
-    this._rawRelated = data.related ?? [];
-
-    this._terms = null;
-    this._definitions = null;
-    this._sources = null;
-    this._notes = null;
-    this._annotations = null;
-    this._examples = null;
-    this._dates = null;
-    this._nonVerbal = null;
-    this._related = null;
-  }
-
-  get terms() {
-    return this._lazy('_terms', '_rawTerms', t => Designation.fromData(t));
-  }
-
-  get definitions() {
-    return this._lazy('_definitions', '_rawDefinition', wrapAs(DetailedDefinition));
-  }
-
-  get definition() {
-    return this.definitions;
-  }
-
-  get sources() {
-    return this._lazy('_sources', '_rawSources', wrapAs(ConceptSource));
-  }
-
-  get notes() {
-    return this._lazy('_notes', '_rawNotes', wrapAs(DetailedDefinition));
-  }
-
-  get annotations() {
-    return this._lazy('_annotations', '_rawAnnotations', wrapAs(DetailedDefinition));
-  }
-
-  get examples() {
-    return this._lazy('_examples', '_rawExamples', wrapAs(DetailedDefinition));
-  }
-
-  get dates() {
-    return this._lazy('_dates', '_rawDates', wrapAs(ConceptDate));
-  }
-
-  get nonVerbalRep() {
-    return this._lazy('_nonVerbal', '_rawNonVerbal', wrapAs(NonVerbRep));
-  }
-
-  get related() {
-    return this._lazy('_related', '_rawRelated', wrapAs(RelatedConcept));
-  }
-
-  get primaryDesignation() {
-    return this.terms[0]?.designation ?? null;
-  }
-
-  get primaryDefinition() {
-    return this.definitions[0]?.content ?? null;
-  }
-
-  *_textSlots() {
-    yield ['definitions', this.definitions];
-    yield ['notes', this.notes];
-    yield ['examples', this.examples];
-    yield ['annotations', this.annotations];
-  }
-
-  /**
-   * Yield every content-text fragment in this localization, recursing
-   * through nested examples. `basePath` prefixes every emitted
-   * `source` path; pass `localizations.<lang>` to get paths consistent
-   * with the rest of the codebase. Designations are not included.
-   */
-  *walkTexts(basePath) {
-    for (const [name, arr] of this._textSlots()) {
-      for (let i = 0; i < arr.length; i++) {
-        yield* arr[i].walkTexts(`${basePath}.${name}[${i}]`);
-      }
-    }
-  }
-
-  toJSON() {
-    const obj = {};
-    if (this.languageCode) obj.language_code = this.languageCode;
-    if (this.script) obj.script = this.script;
-    if (this.system) obj.system = this.system;
-    if (this.entryStatus) obj.entry_status = this.entryStatus;
-    if (this.classification) obj.classification = this.classification;
-    if (this.reviewType) obj.review_type = this.reviewType;
-    if (this.domain) obj.domain = this.domain;
-    if (this.release) obj.release = this.release;
-    if (this.lineageSourceSimilarity != null) obj.lineage_source_similarity = this.lineageSourceSimilarity;
-
-    if (this.reviewDate) obj.review_date = this.reviewDate;
-    if (this.reviewDecisionDate) obj.review_decision_date = this.reviewDecisionDate;
-    if (this.reviewDecisionEvent) obj.review_decision_event = this.reviewDecisionEvent;
-    if (this.reviewStatus) obj.review_status = this.reviewStatus;
-    if (this.reviewDecision) obj.review_decision = this.reviewDecision;
-    if (this.reviewDecisionNotes) obj.review_decision_notes = this.reviewDecisionNotes;
-
-    this._serialize(obj, 'terms', '_terms', '_rawTerms');
-    this._serialize(obj, 'definition', '_definitions', '_rawDefinition');
-    this._serialize(obj, 'notes', '_notes', '_rawNotes');
-    this._serialize(obj, 'annotations', '_annotations', '_rawAnnotations');
-    this._serialize(obj, 'examples', '_examples', '_rawExamples');
-    this._serialize(obj, 'sources', '_sources', '_rawSources');
-    this._serialize(obj, 'dates', '_dates', '_rawDates');
-    this._serialize(obj, 'non_verbal_rep', '_nonVerbal', '_rawNonVerbal');
-    this._serialize(obj, 'related', '_related', '_rawRelated');
-
-    return obj;
-  }
-
-  static fromJSON(data) {
-    return new LocalizedConcept(data);
-  }
-}

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;
-}