glossarist 0.4.50 → 0.4.52

package/dist/models/concept-system.js

@@ -0,0 +1,115 @@
+// 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 {
+    id;
+    name;
+    type;
+    domain;
+    purpose;
+    members;
+    hyperedges;
+    rootConcepts;
+    sources;
+    status;
+    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 inner = ref?.ref ?? ref ?? {};
+    return `${inner.source ?? ''}:${inner.id ?? ''}`;
+}
+export default ConceptSystem;
+//# sourceMappingURL=concept-system.js.map

package/dist/models/concept-system.js.map

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

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

@@ -0,0 +1,7 @@
+export type ConceptType = 'general' | 'individual';
+export declare const CONCEPT_TYPE: Readonly<Record<'GENERAL' | 'INDIVIDUAL', ConceptType>>;
+export declare const CONCEPT_TYPE_VALUES: ReadonlyArray<ConceptType>;
+export declare const DEFAULT_CONCEPT_TYPE: ConceptType;
+export declare function isValidConceptType(value: unknown): value is ConceptType;
+export default CONCEPT_TYPE;
+//# sourceMappingURL=concept-type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concept-type.d.ts","sourceRoot":"","sources":["../../src/models/concept-type.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,CAAC;AAEnD,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,GAAG,YAAY,EAAE,WAAW,CAAC,CAI7E,CAAC;AAEL,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,WAAW,CAE1D,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,WAAkC,CAAC;AAEtE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAKvE;AAED,eAAe,YAAY,CAAC"}

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

@@ -8,26 +8,15 @@
 // Individual concepts occupy the bottom rung of a concept ladder
 // and cannot be subdivided into more specific concepts, but CAN be
 // subdivided into parts via a partitive relation.
-
-export type ConceptType = 'general' | 'individual';
-
-export const CONCEPT_TYPE: Readonly<Record<'GENERAL' | 'INDIVIDUAL', ConceptType>> =
-  Object.freeze({
+export const CONCEPT_TYPE = Object.freeze({
     GENERAL: 'general',
     INDIVIDUAL: 'individual',
-  });
-
-export const CONCEPT_TYPE_VALUES: ReadonlyArray<ConceptType> = Object.freeze(
-  Object.values(CONCEPT_TYPE),
-);
-
-export const DEFAULT_CONCEPT_TYPE: ConceptType = CONCEPT_TYPE.GENERAL;
-
-export function isValidConceptType(value: unknown): value is ConceptType {
-  return (
-    typeof value === 'string' &&
-    (CONCEPT_TYPE_VALUES as readonly string[]).includes(value)
-  );
+});
+export const CONCEPT_TYPE_VALUES = Object.freeze(Object.values(CONCEPT_TYPE));
+export const DEFAULT_CONCEPT_TYPE = CONCEPT_TYPE.GENERAL;
+export function isValidConceptType(value) {
+    return (typeof value === 'string' &&
+        CONCEPT_TYPE_VALUES.includes(value));
 }
-
 export default CONCEPT_TYPE;
+//# sourceMappingURL=concept-type.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concept-type.js","sourceRoot":"","sources":["../../src/models/concept-type.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,8DAA8D;AAC9D,kDAAkD;AAClD,wDAAwD;AACxD,6DAA6D;AAC7D,EAAE;AACF,iEAAiE;AACjE,mEAAmE;AACnE,kDAAkD;AAIlD,MAAM,CAAC,MAAM,YAAY,GACvB,MAAM,CAAC,MAAM,CAAC;IACZ,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;CACzB,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,mBAAmB,GAA+B,MAAM,CAAC,MAAM,CAC1E,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAgB,YAAY,CAAC,OAAO,CAAC;AAEtE,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACxB,mBAAyC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAC3D,CAAC;AACJ,CAAC;AAED,eAAe,YAAY,CAAC"}

package/dist/models/concept.d.ts

@@ -0,0 +1,94 @@
+import { GlossaristModel } from './base.js';
+import { LocalizedConcept } from './localized-concept.js';
+import type { LocalizedConceptJson } from './localized-concept.js';
+import { RelatedConcept } from './related-concept.js';
+import type { RelatedConceptJson } from './related-concept.js';
+import { AbstractHyperedge } from './abstract-hyperedge.js';
+import { ConceptReference } from './concept-reference.js';
+import type { ConceptReferenceJson } from './concept-reference.js';
+import { ConceptDate } from './concept-date.js';
+import type { ConceptDateJson } from './concept-date.js';
+import { ConceptSource } from './concept-source.js';
+import type { ConceptSourceJson } 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';
+export interface ConceptJson {
+    id?: string;
+    termid?: string;
+    term?: string | null;
+    uri?: string | null;
+    localizations?: Record<string, LocalizedConceptJson>;
+    related?: ReadonlyArray<RelatedConceptJson | RelatedConcept>;
+    relatedConcepts?: ReadonlyArray<RelatedConceptJson | RelatedConcept>;
+    related_concepts?: ReadonlyArray<RelatedConceptJson | RelatedConcept>;
+    relations?: ReadonlyArray<unknown>;
+    domains?: ReadonlyArray<ConceptReferenceJson | ConceptReference>;
+    groups?: ReadonlyArray<string | {
+        id?: string;
+        sectionId?: string;
+    } | ConceptReferenceJson>;
+    sections?: ReadonlyArray<string | {
+        id?: string;
+        sectionId?: string;
+    }>;
+    tags?: ReadonlyArray<string>;
+    dates?: ReadonlyArray<ConceptDateJson | ConceptDate>;
+    sources?: ReadonlyArray<ConceptSourceJson | ConceptSource>;
+    figures?: ReadonlyArray<unknown>;
+    tables?: ReadonlyArray<unknown>;
+    formulas?: ReadonlyArray<unknown>;
+    status?: string | null;
+    schemaVersion?: string;
+    schema_version?: string;
+    raw?: unknown;
+    [key: string]: unknown;
+}
+export declare class Concept extends GlossaristModel {
+    static get DIFF_FIELDS(): ReadonlyArray<string>;
+    static wireNameFor(field: string): string;
+    readonly id: string;
+    readonly term: string | null;
+    readonly uri: string | null;
+    private readonly _rawLocalizations;
+    private _cache;
+    readonly relatedConcepts: ReadonlyArray<RelatedConcept>;
+    relations: ReadonlyArray<AbstractHyperedge>;
+    readonly domains: ReadonlyArray<ConceptReference>;
+    readonly groups: ReadonlyArray<string>;
+    readonly sections: ReadonlyArray<string>;
+    readonly tags: ReadonlyArray<string>;
+    readonly dates: ReadonlyArray<ConceptDate>;
+    readonly sources: ReadonlyArray<ConceptSource>;
+    private readonly _rawFigures;
+    private readonly _rawTables;
+    private readonly _rawFormulas;
+    private _figures;
+    private _tables;
+    private _formulas;
+    readonly status: string | null;
+    readonly schemaVersion: string;
+    readonly raw: unknown;
+    constructor(data?: ConceptJson);
+    get termid(): string;
+    get languages(): string[];
+    get languageCodes(): string[];
+    localization(lang: string): LocalizedConcept | undefined;
+    diff(other: Concept, language?: string): unknown;
+    primaryDesignation(lang: string): unknown;
+    definition(lang: string): unknown;
+    setLocalization(lang: string, lc: LocalizedConcept | LocalizedConceptJson): this;
+    hasLocalization(lang: string): boolean;
+    findSourceById(id: string): ConceptSource | null;
+    get figures(): ReadonlyArray<FigureReference>;
+    get tables(): ReadonlyArray<TableReference>;
+    get formulas(): ReadonlyArray<FormulaReference>;
+    walkTexts(): Generator<{
+        text: string;
+        source: string;
+        language?: string;
+    }>;
+    toJSON(): ConceptJson;
+    static fromJSON(data: ConceptJson): Concept;
+}
+//# sourceMappingURL=concept.d.ts.map

package/dist/models/concept.d.ts.map

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

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