glossarist 0.4.49 → 0.4.51

package/dist/models/concept.js

@@ -0,0 +1,368 @@
+import { GlossaristModel } from './base.js';
+import { LocalizedConcept } from './localized-concept.js';
+import { RelatedConcept } from './related-concept.js';
+import { PartitiveHyperedge } from './partitive-hyperedge.js';
+import { AbstractHyperedge } from './abstract-hyperedge.js';
+import { HyperedgeRegistry, groupHyperedgesByWireKey } from './hyperedge-registry.js';
+import { migrateHyperedgeToRelation } from '../migration/hyperedge-migrator.js';
+import { ConceptReference } from './concept-reference.js';
+import { ConceptDate } from './concept-date.js';
+import { ConceptSource } from './concept-source.js';
+import { FigureReference } from './non-verbal-references.js';
+import { TableReference } from './non-verbal-references.js';
+import { FormulaReference } from './non-verbal-references.js';
+import { diffConcepts } from '../diff/concept-diff.js';
+const CONCEPT_WIRE_NAMES = Object.freeze({
+    schemaVersion: 'schema_version',
+});
+export class Concept extends GlossaristModel {
+    static get DIFF_FIELDS() {
+        return Object.freeze(['status', 'term', 'uri', 'schemaVersion']);
+    }
+    static wireNameFor(field) {
+        return CONCEPT_WIRE_NAMES[field] ?? field;
+    }
+    id;
+    term;
+    uri;
+    _rawLocalizations;
+    _cache = {};
+    relatedConcepts;
+    relations;
+    domains;
+    groups;
+    sections;
+    tags;
+    dates;
+    sources;
+    _rawFigures;
+    _rawTables;
+    _rawFormulas;
+    _figures = null;
+    _tables = null;
+    _formulas = null;
+    status;
+    schemaVersion;
+    raw;
+    constructor(data = {}) {
+        super();
+        this.id = String(data.id ?? data.termid ?? '');
+        this.term = data.term ?? null;
+        this.uri = data.uri ?? null;
+        this._rawLocalizations =
+            data.localizations ?? {};
+        this._cache = {};
+        this.relatedConcepts = _mapInstances((data.relatedConcepts ?? data.related ?? data.related_concepts ?? []), RelatedConcept);
+        this.relations = _resolveHyperedges(data);
+        this.domains = _normalizeDomains(data.domains, data.groups);
+        this.groups = Array.isArray(data.groups)
+            ? data.groups
+                .map((g) => typeof g === 'string'
+                ? g
+                : g?.id ??
+                    g?.sectionId ??
+                    null)
+                .filter((g) => Boolean(g))
+            : [];
+        this.sections = Array.isArray(data.sections)
+            ? data.sections
+                .map((s) => typeof s === 'string'
+                ? s
+                : s?.id ??
+                    s?.sectionId ??
+                    null)
+                .filter((s) => Boolean(s))
+            : [];
+        this.tags = Array.isArray(data.tags) ? [...data.tags] : [];
+        this.dates = _mapInstances((data.dates ?? []), ConceptDate);
+        this.sources = _mapInstances((data.sources ?? []), ConceptSource);
+        this._rawFigures = data.figures ?? [];
+        this._rawTables = data.tables ?? [];
+        this._rawFormulas = data.formulas ?? [];
+        this.status = data.status ?? null;
+        this.schemaVersion = data.schemaVersion ?? data.schema_version ?? '3';
+        this.raw = data.raw ?? null;
+    }
+    get termid() { return this.id; }
+    get languages() {
+        return Object.keys(this._rawLocalizations);
+    }
+    get languageCodes() {
+        return this.languages;
+    }
+    localization(lang) {
+        if (!(lang in this._rawLocalizations))
+            return undefined;
+        if (!this._cache[lang]) {
+            const raw = this._rawLocalizations[lang];
+            this._cache[lang] = new LocalizedConcept({ ...raw, language_code: lang });
+        }
+        return this._cache[lang];
+    }
+    diff(other, language = 'eng') {
+        return diffConcepts(this, other, language);
+    }
+    primaryDesignation(lang) {
+        return (this.localization(lang)
+            ?.primaryDesignation ?? null);
+    }
+    definition(lang) {
+        return (this.localization(lang)
+            ?.primaryDefinition ?? null);
+    }
+    setLocalization(lang, lc) {
+        if (lc instanceof LocalizedConcept) {
+            this._cache[lang] = lc;
+            const json = lc.toJSON();
+            delete json.language_code;
+            this._rawLocalizations[lang] = json;
+        }
+        else {
+            this._rawLocalizations[lang] = lc;
+            delete this._cache[lang];
+        }
+        return this;
+    }
+    hasLocalization(lang) {
+        return lang in this._rawLocalizations;
+    }
+    findSourceById(id) {
+        if (typeof id !== 'string' || id.length === 0)
+            return null;
+        for (const source of this.sources) {
+            if (source.id === id)
+                return source;
+        }
+        for (const lang of this.languages) {
+            const lc = this.localization(lang);
+            if (!lc)
+                continue;
+            const lcSources = lc.sources ?? [];
+            for (const source of lcSources) {
+                if (source.id === id)
+                    return source;
+            }
+            const lcTerms = lc.terms ?? [];
+            for (const designation of lcTerms) {
+                for (const source of designation.sources ?? []) {
+                    if (source.id === id)
+                        return source;
+                }
+            }
+        }
+        return null;
+    }
+    get figures() {
+        return this._lazy('_figures', '_rawFigures', (r) => FigureReference.fromJSON(r));
+    }
+    get tables() {
+        return this._lazy('_tables', '_rawTables', (r) => TableReference.fromJSON(r));
+    }
+    get formulas() {
+        return this._lazy('_formulas', '_rawFormulas', (r) => FormulaReference.fromJSON(r));
+    }
+    *walkTexts() {
+        for (const lang of this.languages) {
+            const lc = this.localization(lang);
+            if (!lc)
+                continue;
+            const walker = lc.walkTexts;
+            if (typeof walker === 'function') {
+                yield* walker.call(lc, `localizations.${lang}`);
+            }
+        }
+    }
+    toJSON() {
+        const obj = { id: this.id };
+        if (this.term != null)
+            obj.term = this.term;
+        if (this.uri != null)
+            obj.uri = this.uri;
+        if (Object.keys(this._rawLocalizations).length > 0) {
+            obj.localizations = {};
+            const loc = obj.localizations;
+            for (const lang of this.languages) {
+                const lc = this.localization(lang);
+                if (lc) {
+                    const json = lc.toJSON();
+                    delete json.language_code;
+                    loc[lang] = json;
+                }
+            }
+        }
+        else {
+            obj.localizations = {};
+        }
+        if (this.relatedConcepts.length > 0) {
+            obj.related = this.relatedConcepts.map((rc) => rc.toJSON());
+        }
+        const grouped = groupHyperedgesByWireKey(this.relations);
+        for (const [wireKey, rels] of Object.entries(grouped)) {
+            if (rels.length > 0)
+                obj[wireKey] = rels.map((r) => r.toJSON());
+        }
+        if (this.domains.length > 0) {
+            obj.domains = this.domains.map((d) => d.toJSON());
+        }
+        if (this.tags.length > 0) {
+            obj.tags = [...this.tags];
+        }
+        if (this.dates.length > 0) {
+            obj.dates = this.dates.map((d) => d.toJSON());
+        }
+        if (this.sources.length > 0) {
+            obj.sources = this.sources.map((s) => s.toJSON());
+        }
+        this._serialize(obj, 'figures', '_figures', '_rawFigures');
+        this._serialize(obj, 'tables', '_tables', '_rawTables');
+        this._serialize(obj, 'formulas', '_formulas', '_rawFormulas');
+        if (this.status != null)
+            obj.status = this.status;
+        obj.schema_version = this.schemaVersion;
+        return obj;
+    }
+    static fromJSON(data) {
+        return new Concept(data);
+    }
+}
+function _mapInstances(arr, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+Cls) {
+    return arr.map((item) => (item instanceof Cls ? item : new Cls(item)));
+}
+function _resolveHyperedges(data) {
+    _assertNoAmbiguousInput(data);
+    const relations = data.relations;
+    if (Array.isArray(relations)) {
+        const out = [];
+        for (const r of relations) {
+            const coerced = _coerceHyperedge(r);
+            if (coerced)
+                out.push(coerced);
+        }
+        return _dedupeOrThrow(out);
+    }
+    const out = [];
+    for (const cls of HyperedgeRegistry.allClasses()) {
+        const arr = data[cls.wireKey];
+        const camelArr = data[_camelCase(cls.wireKey)];
+        const source = arr ?? camelArr;
+        if (!Array.isArray(source))
+            continue;
+        for (const r of source) {
+            const coerced = _coerceHyperedge(r, cls);
+            if (coerced)
+                out.push(coerced);
+        }
+    }
+    for (const cls of HyperedgeRegistry.allClasses()) {
+        for (const v1Key of cls.v1WireKeys ?? []) {
+            const camelV1 = _camelCase(v1Key);
+            const arr = data[v1Key];
+            const camelArr = data[camelV1];
+            const source = arr ?? camelArr;
+            if (!Array.isArray(source))
+                continue;
+            for (const h of source) {
+                const migrated = _migrateV1Hash(cls, v1Key, h);
+                if (migrated) {
+                    const Ctor = cls;
+                    out.push(new Ctor(migrated));
+                }
+            }
+        }
+    }
+    return _dedupeOrThrow(out);
+}
+function _assertNoAmbiguousInput(data) {
+    if (!Array.isArray(data.relations))
+        return;
+    const typedKeys = [];
+    for (const cls of HyperedgeRegistry.allClasses()) {
+        if (Array.isArray(data[cls.wireKey]))
+            typedKeys.push(cls.wireKey);
+        const camelWire = _camelCase(cls.wireKey);
+        if (camelWire !== cls.wireKey && Array.isArray(data[camelWire])) {
+            typedKeys.push(camelWire);
+        }
+        for (const v1 of cls.v1WireKeys ?? []) {
+            if (Array.isArray(data[v1]))
+                typedKeys.push(v1);
+            const camelV1 = _camelCase(v1);
+            if (camelV1 !== v1 && Array.isArray(data[camelV1]))
+                typedKeys.push(camelV1);
+        }
+    }
+    if (typedKeys.length > 0) {
+        throw new Error(`Concept input is ambiguous: pass either 'relations' (unified) ` +
+            `or typed wire keys (${typedKeys.join(', ')}), not both.`);
+    }
+}
+function _dedupeOrThrow(relations) {
+    const seen = new Map();
+    for (const r of relations) {
+        const id = _hyperedgeIdentity(r);
+        if (seen.has(id)) {
+            throw new Error(`Concept input has duplicate hyperedge (identity=${id}). ` +
+                `Passing the same relation twice is a bug.`);
+        }
+        seen.set(id, r);
+    }
+    return relations;
+}
+function _hyperedgeIdentity(r) {
+    if (r == null)
+        return '';
+    const Cls = r.constructor;
+    if (typeof Cls?.identityOf === 'function') {
+        return `${Cls.name}::${Cls.identityOf(r)}`;
+    }
+    return String(r);
+}
+function _coerceHyperedge(value, fallbackClass) {
+    if (value == null)
+        return null;
+    if (value instanceof AbstractHyperedge)
+        return value;
+    const hash = typeof value.toJSON === 'function'
+        ? value.toJSON()
+        : value;
+    const cls = _classForHash(hash) ?? fallbackClass;
+    if (!cls)
+        return null;
+    const Ctor = cls;
+    return new Ctor(hash);
+}
+function _classForHash(hash) {
+    if (!hash || typeof hash !== 'object')
+        return null;
+    const type = hash.type;
+    if (typeof type !== 'string')
+        return null;
+    return HyperedgeRegistry.forTypeTag(type);
+}
+function _migrateV1Hash(cls, v1Key, hash) {
+    if (cls === PartitiveHyperedge && v1Key === 'partitive_hyperedges') {
+        return migrateHyperedgeToRelation(hash);
+    }
+    return null;
+}
+function _camelCase(s) {
+    if (typeof s !== 'string' || !s.includes('_'))
+        return s;
+    return s.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+function _normalizeDomains(domains, groups) {
+    if (domains) {
+        return domains.map((d) => d instanceof ConceptReference
+            ? d
+            : new ConceptReference(d));
+    }
+    if (groups) {
+        return groups.map((g) => typeof g === 'string'
+            ? ConceptReference.domain(g)
+            : new ConceptReference(g));
+    }
+    return [];
+}
+//# sourceMappingURL=concept.js.map

package/dist/models/concept.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept.js","sourceRoot":"","sources":["../../src/models/concept.ts"],"names":[],"mappings":"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"}

package/dist/models/dataset-color.d.ts

@@ -0,0 +1,28 @@
+export type ColorMode = 'light' | 'dark';
+export type DatasetColorSpec = string;
+export interface DatasetColorPair {
+    light?: string;
+    dark?: string;
+}
+export type DatasetColor = DatasetColorSpec | DatasetColorPair;
+export declare const COLOR_MODES: ReadonlyArray<ColorMode>;
+/**
+ * Returns the right hex for the given mode. Falls back to the single
+ * hex when the spec is a string. Returns null when the spec is null
+ * or when the requested mode is missing from a pair.
+ */
+export declare function resolveColor(color: DatasetColor | null | undefined, mode: ColorMode): string | null;
+/**
+ * True when the spec declares an explicit {light, dark} object.
+ */
+export declare function isColorPair(color: DatasetColor | null | undefined): color is DatasetColorPair;
+/**
+ * Validates a color spec. A valid spec is either:
+ *   - a string matching /^#[0-9a-fA-F]{3,8}$/
+ *   - an object with `light` and `dark` string fields, each matching
+ *     the same pattern
+ *
+ * Returns null when valid, or an error message describing the issue.
+ */
+export declare function validateColor(color: DatasetColor | null | undefined): string | null;
+//# sourceMappingURL=dataset-color.d.ts.map

package/dist/models/dataset-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-color.d.ts","sourceRoot":"","sources":["../../src/models/dataset-color.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAE/D,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,SAAS,CAG/C,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EACtC,IAAI,EAAE,SAAS,GACd,MAAM,GAAG,IAAI,CAQf;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GACrC,KAAK,IAAI,gBAAgB,CAE3B;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GACrC,MAAM,GAAG,IAAI,CAkBf"}

package/dist/models/dataset-color.js

@@ -0,0 +1,74 @@
+// Per-dataset color spec, light/dark variants.
+//
+// A DatasetColor may be:
+//   - a single hex string (legacy, applied to both modes)
+//   - an explicit { light, dark } pair
+//
+// Round-trips through Register.toJSON unchanged so the data lives in
+// the GCR package. Consumers call resolveColor(mode) to pick the
+// right hex for the current UI mode.
+export const COLOR_MODES = Object.freeze([
+    'light',
+    'dark',
+]);
+/**
+ * Returns the right hex for the given mode. Falls back to the single
+ * hex when the spec is a string. Returns null when the spec is null
+ * or when the requested mode is missing from a pair.
+ */
+export function resolveColor(color, mode) {
+    if (color == null)
+        return null;
+    if (typeof color === 'string')
+        return color;
+    if (typeof color === 'object') {
+        if (!mode)
+            return color.light ?? color.dark ?? null;
+        return color[mode] ?? null;
+    }
+    return null;
+}
+/**
+ * True when the spec declares an explicit {light, dark} object.
+ */
+export function isColorPair(color) {
+    return color != null && typeof color === 'object';
+}
+/**
+ * Validates a color spec. A valid spec is either:
+ *   - a string matching /^#[0-9a-fA-F]{3,8}$/
+ *   - an object with `light` and `dark` string fields, each matching
+ *     the same pattern
+ *
+ * Returns null when valid, or an error message describing the issue.
+ */
+export function validateColor(color) {
+    if (color == null)
+        return null;
+    if (typeof color === 'string')
+        return hexError(color);
+    if (typeof color === 'object') {
+        if (color.light == null && color.dark == null) {
+            return 'color pair must have at least one of `light` or `dark`';
+        }
+        if (color.light != null) {
+            const e = hexError(color.light);
+            if (e)
+                return `color.light: ${e}`;
+        }
+        if (color.dark != null) {
+            const e = hexError(color.dark);
+            if (e)
+                return `color.dark: ${e}`;
+        }
+        return null;
+    }
+    return `unexpected color type ${typeof color}`;
+}
+const HEX_RE = /^#[0-9a-fA-F]{3,8}$/;
+function hexError(s) {
+    if (typeof s !== 'string')
+        return `expected string, got ${typeof s}`;
+    return HEX_RE.test(s) ? null : `not a valid hex color: ${JSON.stringify(s)}`;
+}
+//# sourceMappingURL=dataset-color.js.map

package/dist/models/dataset-color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-color.js","sourceRoot":"","sources":["../../src/models/dataset-color.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,yBAAyB;AACzB,0DAA0D;AAC1D,uCAAuC;AACvC,EAAE;AACF,qEAAqE;AACrE,iEAAiE;AACjE,qCAAqC;AAarC,MAAM,CAAC,MAAM,WAAW,GAA6B,MAAM,CAAC,MAAM,CAAC;IACjE,OAAO;IACP,MAAM;CACP,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAsC,EACtC,IAAe;IAEf,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC;QACpD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC7B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,KAAsC;IAEtC,OAAO,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAsC;IAEtC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;YAC9C,OAAO,wDAAwD,CAAC;QAClE,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC;gBAAE,OAAO,gBAAgB,CAAC,EAAE,CAAC;QACpC,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,CAAC;gBAAE,OAAO,eAAe,CAAC,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,yBAAyB,OAAO,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,MAAM,GAAG,qBAAqB,CAAC;AACrC,SAAS,QAAQ,CAAC,CAAU;IAC1B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,wBAAwB,OAAO,CAAC,EAAE,CAAC;IACrE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/models/definition-type.d.ts

@@ -0,0 +1,9 @@
+export type DefinitionType = 'intensional' | 'extensional' | 'partitive' | 'translated';
+export declare const DEFINITION_TYPE: import("./enum.js").EnumBundle<{
+    readonly INTENSIONAL: "intensional";
+    readonly EXTENSIONAL: "extensional";
+    readonly PARTITIVE: "partitive";
+    readonly TRANSLATED: "translated";
+}>;
+export declare const DEFAULT_DEFINITION_TYPE: DefinitionType;
+//# sourceMappingURL=definition-type.d.ts.map

package/dist/models/definition-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-type.d.ts","sourceRoot":"","sources":["../../src/models/definition-type.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,aAAa,GACb,WAAW,GACX,YAAY,CAAC;AAEjB,eAAO,MAAM,eAAe;;;;;EAK1B,CAAC;AAEH,eAAO,MAAM,uBAAuB,EAAE,cACT,CAAC"}

package/{src/models/definition-type.ts → dist/models/definition-type.js}

@@ -4,21 +4,12 @@
 //   extensional:           enumerate instances or species
 //   partitive:             describe composition
 //   translated:            translated from another language
-
 import { makeEnum } from './enum.js';
-
-export type DefinitionType =
-  | 'intensional'
-  | 'extensional'
-  | 'partitive'
-  | 'translated';
-
 export const DEFINITION_TYPE = makeEnum('DEFINITION_TYPE', {
-  INTENSIONAL: 'intensional',
-  EXTENSIONAL: 'extensional',
-  PARTITIVE: 'partitive',
-  TRANSLATED: 'translated',
+    INTENSIONAL: 'intensional',
+    EXTENSIONAL: 'extensional',
+    PARTITIVE: 'partitive',
+    TRANSLATED: 'translated',
 });
-
-export const DEFAULT_DEFINITION_TYPE: DefinitionType =
-  DEFINITION_TYPE.INTENSIONAL;
+export const DEFAULT_DEFINITION_TYPE = DEFINITION_TYPE.INTENSIONAL;
+//# sourceMappingURL=definition-type.js.map

package/dist/models/definition-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-type.js","sourceRoot":"","sources":["../../src/models/definition-type.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,gDAAgD;AAChD,0DAA0D;AAC1D,gDAAgD;AAChD,4DAA4D;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAQrC,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC,iBAAiB,EAAE;IACzD,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAClC,eAAe,CAAC,WAAW,CAAC"}

package/dist/models/designation-relationship.d.ts

@@ -0,0 +1,17 @@
+import { GlossaristModel } from './base.js';
+export declare const DESIGNATION_RELATIONSHIP_TYPES: ReadonlyArray<string>;
+export type DesignationRelationshipType = string;
+export interface DesignationRelationshipJson {
+    type?: DesignationRelationshipType | null;
+    content?: string | null;
+    target?: string | null;
+}
+export declare class DesignationRelationship extends GlossaristModel {
+    readonly type: DesignationRelationshipType | null;
+    readonly content: string | null;
+    readonly target: string | null;
+    constructor(data?: DesignationRelationshipJson);
+    toJSON(): DesignationRelationshipJson;
+    static fromJSON(data: DesignationRelationshipJson): DesignationRelationship;
+}
+//# sourceMappingURL=designation-relationship.d.ts.map

package/dist/models/designation-relationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"designation-relationship.d.ts","sourceRoot":"","sources":["../../src/models/designation-relationship.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,eAAO,MAAM,8BAA8B,EAAE,aAAa,CAAC,MAAM,CAG/D,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,qBAAa,uBAAwB,SAAQ,eAAe;IAC1D,QAAQ,CAAC,IAAI,EAAE,2BAA2B,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEnB,IAAI,GAAE,2BAAgC;IAOzC,MAAM,IAAI,2BAA2B;WAQ9B,QAAQ,CAAC,IAAI,EAAE,2BAA2B,GAAG,uBAAuB;CAGrF"}

package/dist/models/designation-relationship.js

@@ -0,0 +1,30 @@
+import { GlossaristModel } from './base.js';
+export const DESIGNATION_RELATIONSHIP_TYPES = Object.freeze([
+    // TBX (ISO 30042) / ISO 12620 term-level relationships
+    'abbreviated_form_for', 'short_form_for',
+]);
+export class DesignationRelationship extends GlossaristModel {
+    type;
+    content;
+    target;
+    constructor(data = {}) {
+        super();
+        this.type = data.type ?? null;
+        this.content = data.content ?? null;
+        this.target = data.target ?? null;
+    }
+    toJSON() {
+        const obj = {};
+        if (this.type != null)
+            obj.type = this.type;
+        if (this.content != null)
+            obj.content = this.content;
+        if (this.target != null)
+            obj.target = this.target;
+        return obj;
+    }
+    static fromJSON(data) {
+        return new DesignationRelationship(data);
+    }
+}
+//# sourceMappingURL=designation-relationship.js.map

package/dist/models/designation-relationship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"designation-relationship.js","sourceRoot":"","sources":["../../src/models/designation-relationship.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,CAAC,MAAM,8BAA8B,GAA0B,MAAM,CAAC,MAAM,CAAC;IACjF,uDAAuD;IACvD,sBAAsB,EAAE,gBAAgB;CACzC,CAAC,CAAC;AAUH,MAAM,OAAO,uBAAwB,SAAQ,eAAe;IACjD,IAAI,CAAqC;IACzC,OAAO,CAAgB;IACvB,MAAM,CAAgB;IAE/B,YAAY,OAAoC,EAAE;QAChD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IACpC,CAAC;IAEQ,MAAM;QACb,MAAM,GAAG,GAAgC,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAC5C,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI;YAAE,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QACrD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAClD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,CAAU,QAAQ,CAAC,IAAiC;QACxD,OAAO,IAAI,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF"}