glossarist 0.4.39 → 0.4.40

package/src/models/relation-categories.js

@@ -1,182 +0,0 @@
-// Categorization SSOT for the 52 glossarist relationship types.
-//
-// Each type in RELATIONSHIP_TYPES belongs to exactly one category. The
-// categories mirror the concept-model taxonomy
-// (concept-browser:src/data/taxonomies.json) so JS consumers and the
-// Vue UI see the same buckets. Adding a new type means adding a
-// taxonomy entry — no code changes here.
-//
-// The 8 categories:
-//   lifecycle      — supersession, deprecation, replacement
-//   hierarchical   — SKOS + ISO 25964 broader/narrower (generic/partitive/instantial)
-//   associative    — generic see-also references
-//   comparative    — compare / contrast
-//   spatiotemporal — sequential, spatial, temporal
-//   lexical        — homograph, false_friend (cross-language)
-//   mapping        — SKOS mapping properties (cross-vocabulary)
-//   definitional   — ISO 19135 concept-to-concept relations: definition, part,
-//                    instance, inheritance, versioning
-//
-// Designation-level relationships (abbreviated_form_for, short_form_for)
-// are a separate concern — see DESIGNATION_RELATIONSHIP_TYPES.
-
-import { RELATIONSHIP_TYPES } from './related-concept.js';
-
-// Category definitions. The `types` array is the exhaustive list of
-// relationship-type local names that fall into the category. Each type
-// must appear in exactly one category (verified by MECE test).
-export const RELATION_CATEGORIES = Object.freeze({
-  lifecycle: Object.freeze({
-    label: 'Lifecycle',
-    description: 'Concept lifecycle transitions: supersession, deprecation, replacement.',
-    types: Object.freeze([
-      'deprecates', 'deprecated_by',
-      'supersedes', 'superseded_by',
-      'replaces', 'replaced_by',
-      'invalidates', 'invalidated_by',
-      'retires', 'retired_by',
-    ]),
-  }),
-
-  hierarchical: Object.freeze({
-    label: 'Hierarchical',
-    description: 'Broader/narrower relations, including SKOS and ISO 25964 generic/partitive/instantial.',
-    types: Object.freeze([
-      'broader', 'narrower',
-      'broader_generic', 'narrower_generic',
-      'broader_partitive', 'narrower_partitive',
-      'broader_instantial', 'narrower_instantial',
-    ]),
-  }),
-
-  associative: Object.freeze({
-    label: 'Associative',
-    description: 'Generic see-also references between concepts.',
-    types: Object.freeze([
-      'see', 'related_concept',
-      'related_concept_broader', 'related_concept_narrower',
-      'references',
-    ]),
-  }),
-
-  comparative: Object.freeze({
-    label: 'Comparative',
-    description: 'Compare / contrast relations between concepts.',
-    types: Object.freeze(['compare', 'contrast']),
-  }),
-
-  spatiotemporal: Object.freeze({
-    label: 'Spatiotemporal',
-    description: 'Sequential, spatial, and temporal relations.',
-    types: Object.freeze([
-      'sequentially_related_concept',
-      'spatially_related_concept',
-      'temporally_related_concept',
-    ]),
-  }),
-
-  lexical: Object.freeze({
-    label: 'Lexical',
-    description: 'Lexical relations between designations across languages.',
-    types: Object.freeze(['homograph', 'false_friend']),
-  }),
-
-  mapping: Object.freeze({
-    label: 'Mapping',
-    description: 'SKOS mapping properties for cross-vocabulary alignment.',
-    types: Object.freeze([
-      'equivalent', 'close_match',
-      'broad_match', 'narrow_match', 'related_match',
-    ]),
-  }),
-
-  // ISO 19135 concept-to-concept relations. Replaces the previous
-  // `conceptInstance` and `versioning` split — concept-browser's
-  // taxonomy treats versioning as part of the definitional cluster
-  // (a version IS a definitional variant of the same concept identity).
-  // Renaming aligns glossarist-js with the canonical taxonomy at
-  // concept-browser:src/data/taxonomies.json.
-  //
-  // `provides` / `provided_by` (Glossarist v2 extension) live here too:
-  // they record ExternalConcept resolution — a definitional linkage
-  // between a placeholder and the concept that fills its substance.
-  // See TODO.partitive-relation-v2 item 07.
-  definitional: Object.freeze({
-    label: 'Definitional',
-    description: 'ISO 19135 concept-to-concept relations: definition, part, instance, inheritance, versioning.',
-    types: Object.freeze([
-      'has_concept', 'is_concept_of',
-      'instance_of', 'has_instance',
-      'has_definition', 'definition_of',
-      'has_part', 'is_part_of',
-      'inherits', 'inherited_by',
-      'has_version', 'version_of',
-      'current_version', 'current_version_of',
-      'provides', 'provided_by',
-    ]),
-  }),
-});
-
-// Reverse index built once. Maps each type local name to its category.
-const _CATEGORY_BY_TYPE = (() => {
-  const map = new Map();
-  for (const [cat, def] of Object.entries(RELATION_CATEGORIES)) {
-    for (const t of def.types) map.set(t, cat);
-  }
-  return map;
-})();
-
-// Backward-compat aliases for callers that adopted the original
-// glossarist-js naming (v0.4.6). Resolved at lookup time so any of
-// the three names returns the definitional category.
-const _CATEGORY_ALIASES = {
-  conceptInstance: 'definitional',
-  versioning: 'definitional',
-};
-
-/**
- * Returns the category key for the given relationship type, or null
- * when the type is not categorized (e.g. an unrecognized custom type).
- */
-export function categoryOf(type) {
-  return _CATEGORY_BY_TYPE.get(type) ?? null;
-}
-
-/**
- * Returns the category definition ({ label, description, types }) for
- * the given category key. Accepts both canonical names (definitional)
- * and aliases from earlier glossarist-js versions (conceptInstance,
- * versioning) for backward compatibility.
- */
-export function categoryDefinition(categoryKey) {
-  const canonical = _CATEGORY_ALIASES[categoryKey] ?? categoryKey;
-  return RELATION_CATEGORIES[canonical] ?? null;
-}
-
-/**
- * MECE sanity check. Returns the list of relationship types that are
- * NOT categorized (i.e. present in RELATIONSHIP_TYPES but missing from
- * RELATION_CATEGORIES). Used by the test suite to verify SSOT drift.
- */
-export function uncategorizedTypes() {
-  return RELATIONSHIP_TYPES.filter(t => !_CATEGORY_BY_TYPE.has(t));
-}
-
-/**
- * MECE sanity check. Returns a list of { type, categories } entries
- * for any type that appears in MORE than one category. Should be
- * empty when the categorization is mutually exclusive.
- */
-export function duplicatedTypes() {
-  const counts = new Map();
-  for (const def of Object.values(RELATION_CATEGORIES)) {
-    for (const t of def.types) {
-      counts.set(t, (counts.get(t) ?? 0) + 1);
-    }
-  }
-  const out = [];
-  for (const [type, count] of counts) {
-    if (count > 1) out.push({ type, count });
-  }
-  return out;
-}

package/src/models/section.js

@@ -1,44 +0,0 @@
-import { GlossaristModel } from './base.js';
-
-export const ORDERING_METHODS = Object.freeze([
-  'systematic',
-  'mixed',
-  'alphabetical',
-]);
-
-export class Section extends GlossaristModel {
-  constructor(data = {}) {
-    super();
-    this.id = data.id ?? null;
-    this.names = data.names ?? {};
-    this.ordering = data.ordering ?? null;
-    this.children = (data.children ?? []).map(c =>
-      c instanceof Section ? c : new Section(c)
-    );
-  }
-
-  name(lang) {
-    return this.names[lang] ?? this.names.eng ?? null;
-  }
-
-  descendantById(id) {
-    for (const child of this.children) {
-      if (child.id === id) return child;
-      const found = child.descendantById(id);
-      if (found) return found;
-    }
-    return null;
-  }
-
-  toJSON() {
-    const obj = { id: this.id };
-    if (Object.keys(this.names).length > 0) obj.names = { ...this.names };
-    if (this.ordering != null) obj.ordering = this.ordering;
-    if (this.children.length > 0) obj.children = this.children.map(c => c.toJSON());
-    return obj;
-  }
-
-  static fromJSON(data) {
-    return new Section(data);
-  }
-}