glossarist 0.4.50 → 0.4.52

package/dist/models/generic-hyperedge.d.ts

@@ -0,0 +1,32 @@
+import { AbstractHyperedge } from './abstract-hyperedge.js';
+import type { AbstractHyperedgeJson } from './abstract-hyperedge.js';
+import { GenericMember } from './generic-member.js';
+import type { GenericMemberJson } from './generic-member.js';
+export interface GenericHyperedgeJson extends AbstractHyperedgeJson {
+    members: ReadonlyArray<GenericMemberJson | GenericMember>;
+}
+export declare class GenericHyperedge extends AbstractHyperedge {
+    static wireKey: "generic_relations";
+    static typeTag: "generic_relation";
+    static rdfType: "gloss:GenericRelation";
+    static memberClass: typeof GenericMember;
+    static v1WireKeys: ReadonlyArray<string>;
+    static kindLabel: string;
+    readonly members: ReadonlyArray<GenericMember>;
+    constructor(data?: Partial<GenericHyperedgeJson>);
+    static identityOf(value: {
+        comprehensive?: {
+            source?: string | null;
+            id?: string | null;
+        } | null;
+        members?: ReadonlyArray<{
+            ref?: {
+                source?: string | null;
+                id?: string | null;
+            } | null;
+        } | null>;
+    } | null | undefined): string;
+    static fromJSON(data: GenericHyperedgeJson): GenericHyperedge;
+}
+export default GenericHyperedge;
+//# sourceMappingURL=generic-hyperedge.d.ts.map

package/dist/models/generic-hyperedge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-hyperedge.d.ts","sourceRoot":"","sources":["../../src/models/generic-hyperedge.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,WAAW,oBAAqB,SAAQ,qBAAqB;IACjE,OAAO,EAAE,aAAa,CAAC,iBAAiB,GAAG,aAAa,CAAC,CAAC;CAC3D;AAED,qBAAa,gBAAiB,SAAQ,iBAAiB;IAErD,MAAM,CAAC,OAAO,EAAG,mBAAmB,CAAU;IAC9C,MAAM,CAAC,OAAO,EAAG,kBAAkB,CAAU;IAC7C,MAAM,CAAC,OAAO,EAAG,uBAAuB,CAAU;IAClD,MAAM,CAAC,WAAW,uBAAiB;IACnC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAM;IAC9C,MAAM,CAAC,SAAS,SAAS;IAEzB,SAAiB,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;gBAE3C,IAAI,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAepD,MAAM,CAAC,UAAU,CACf,KAAK,EAAE;QACL,aAAa,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAC;QACtE,OAAO,CAAC,EAAE,aAAa,CAAC;YAAE,GAAG,CAAC,EAAE;gBAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;gBAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAC,CAAC;KACjG,GAAG,IAAI,GAAG,SAAS,GACnB,MAAM;WAYO,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB;CAGvE;AAED,eAAe,gBAAgB,CAAC"}

package/dist/models/generic-hyperedge.js

@@ -0,0 +1,51 @@
+// GenericHyperedge — an ISO 704 / ISO 1087-1 / ISO 12620 generic
+// relation connecting a comprehensive concept (the genus) to two
+// or more specific concepts (the species) which together constitute
+// a decomposition by some criterion of subdivision.
+//
+// Mirror of PartitiveHyperedge. Multiple GenericRelations on the same
+// comprehensive distinguished by `criterion` is the OIML pattern
+// (5.1 measurement standard has 6 criterion groups).
+//
+// See docs/design/generic-relation.md (concept-model repo).
+import { AbstractHyperedge } from './abstract-hyperedge.js';
+import { GenericMember } from './generic-member.js';
+import { HyperedgeRegistry } from './hyperedge-registry.js';
+export class GenericHyperedge extends AbstractHyperedge {
+    // Per-class metadata block — the OCP contract.
+    static wireKey = 'generic_relations';
+    static typeTag = 'generic_relation';
+    static rdfType = 'gloss:GenericRelation';
+    static memberClass = GenericMember;
+    static v1WireKeys = [];
+    static kindLabel = 'GEN';
+    constructor(data = {}) {
+        super({
+            comprehensive: data.comprehensive ?? {},
+            members: data.members ?? [],
+            completeness: data.completeness ?? 'complete',
+            criterion: data.criterion,
+            sources: data.sources,
+            notes: data.notes,
+            status: data.status,
+        });
+        this.members = (Array.isArray(data.members) ? data.members : []).map((m) => m instanceof GenericMember ? m : new GenericMember(m));
+    }
+    static identityOf(value) {
+        const v = value ?? {};
+        const c = v.comprehensive ?? {};
+        const memberKeys = (v.members ?? [])
+            .map((m) => {
+            const r = m?.ref ?? m ?? {};
+            return `${r.source ?? ''}:${r.id ?? ''}`;
+        })
+            .sort();
+        return `${c.source ?? ''}:${c.id ?? ''}|${memberKeys.join('|')}`;
+    }
+    static fromJSON(data) {
+        return new GenericHyperedge(data);
+    }
+}
+export default GenericHyperedge;
+HyperedgeRegistry.register(GenericHyperedge);
+//# sourceMappingURL=generic-hyperedge.js.map

package/dist/models/generic-hyperedge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-hyperedge.js","sourceRoot":"","sources":["../../src/models/generic-hyperedge.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,iEAAiE;AACjE,oEAAoE;AACpE,oDAAoD;AACpD,EAAE;AACF,sEAAsE;AACtE,iEAAiE;AACjE,qDAAqD;AACrD,EAAE;AACF,4DAA4D;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAM5D,MAAM,OAAO,gBAAiB,SAAQ,iBAAiB;IACrD,+CAA+C;IAC/C,MAAM,CAAC,OAAO,GAAG,mBAA4B,CAAC;IAC9C,MAAM,CAAC,OAAO,GAAG,kBAA2B,CAAC;IAC7C,MAAM,CAAC,OAAO,GAAG,uBAAgC,CAAC;IAClD,MAAM,CAAC,WAAW,GAAG,aAAa,CAAC;IACnC,MAAM,CAAC,UAAU,GAA0B,EAAE,CAAC;IAC9C,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;IAIzB,YAAY,OAAsC,EAAE;QAClD,KAAK,CAAC;YACJ,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;YAC3B,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,UAAU;YAC7C,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzE,CAAC,YAAY,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAsB,CAAC,CAC3E,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,UAAU,CACf,KAGoB;QAEpB,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,CAAC,CAAC,aAAa,IAAI,EAAE,CAAC;QAChC,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,IAAK,CAA6C,IAAI,EAAE,CAAC;YACzE,OAAO,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;QAC3C,CAAC,CAAC;aACD,IAAI,EAAE,CAAC;QACV,OAAO,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IACnE,CAAC;IAED,MAAM,CAAU,QAAQ,CAAC,IAA0B;QACjD,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;;AAGH,eAAe,gBAAgB,CAAC;AAEhC,iBAAiB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/models/generic-member.d.ts

@@ -0,0 +1,14 @@
+import { HyperedgeMember } from './hyperedge-member.js';
+import type { HyperedgeMemberJson } from './hyperedge-member.js';
+export type LocalizedString = Readonly<Record<string, string>>;
+export interface GenericMemberJson extends HyperedgeMemberJson {
+    delimitingCharacteristic: LocalizedString | string;
+}
+export declare class GenericMember extends HyperedgeMember {
+    readonly delimitingCharacteristic: LocalizedString;
+    constructor(data?: GenericMemberJson);
+    toJSON(): GenericMemberJson;
+    static fromJSON(data: GenericMemberJson): GenericMember;
+}
+export default GenericMember;
+//# sourceMappingURL=generic-member.d.ts.map

package/dist/models/generic-member.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-member.d.ts","sourceRoot":"","sources":["../../src/models/generic-member.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/D,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC5D,wBAAwB,EAAE,eAAe,GAAG,MAAM,CAAC;CACpD;AAED,qBAAa,aAAc,SAAQ,eAAe;IAChD,QAAQ,CAAC,wBAAwB,EAAE,eAAe,CAAC;gBAEvC,IAAI,GAAE,iBAAoD;IAO7D,MAAM,IAAI,iBAAiB;WAMpB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa;CAGjE;AAsCD,eAAe,aAAa,CAAC"}

package/dist/models/generic-member.js

@@ -0,0 +1,51 @@
+// GenericMember — one member of a GenericHyperedge.
+//
+// Per ISO 704:2022 §5.5.4.2.1 (Generic relations and general concepts):
+//
+//   "In a generic relation, the intension of the subordinate concept
+//    includes the intension of the superordinate concept plus at least
+//    one additional delimiting characteristic."
+//
+// See docs/design/abstract-hyperedge.md for the full rationale and
+// the computer-mouse worked example.
+import { HyperedgeMember } from './hyperedge-member.js';
+export class GenericMember extends HyperedgeMember {
+    delimitingCharacteristic;
+    constructor(data = { delimitingCharacteristic: {} }) {
+        super(data);
+        this.delimitingCharacteristic = _resolveDelimitingCharacteristic(data.delimitingCharacteristic);
+    }
+    toJSON() {
+        const base = super.toJSON();
+        base.delimitingCharacteristic = { ...this.delimitingCharacteristic };
+        return base;
+    }
+    static fromJSON(data) {
+        return new GenericMember(data);
+    }
+}
+function _resolveDelimitingCharacteristic(value) {
+    if (value == null) {
+        throw new Error('GenericMember.delimitingCharacteristic is required per ISO 704:2022 §5.5.4.2.1 ' +
+            '(the intension of a subordinate concept must include at least one additional ' +
+            'delimiting characteristic beyond the superordinate).');
+    }
+    if (typeof value === 'string') {
+        if (value.length === 0) {
+            throw new Error('GenericMember.delimitingCharacteristic cannot be empty (ISO 704:2022 §5.5.4.2.1)');
+        }
+        return { default: value };
+    }
+    if (typeof value === 'object') {
+        const entries = Object.entries(value).filter(([, v]) => typeof v === 'string' && v.length > 0);
+        if (entries.length === 0) {
+            throw new Error('GenericMember.delimitingCharacteristic must have at least one non-empty string ' +
+                'value (ISO 704:2022 §5.5.4.2.1)');
+        }
+        return Object.fromEntries(entries);
+    }
+    throw new Error(`GenericMember.delimitingCharacteristic must be a string or a language-keyed object; ` +
+        `got ${typeof value}`);
+}
+export default GenericMember;
+//# sourceMappingURL=generic-member.js.map

package/dist/models/generic-member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-member.js","sourceRoot":"","sources":["../../src/models/generic-member.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,wEAAwE;AACxE,EAAE;AACF,qEAAqE;AACrE,uEAAuE;AACvE,gDAAgD;AAChD,EAAE;AACF,mEAAmE;AACnE,qCAAqC;AAErC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AASxD,MAAM,OAAO,aAAc,SAAQ,eAAe;IACvC,wBAAwB,CAAkB;IAEnD,YAAY,OAA0B,EAAE,wBAAwB,EAAE,EAAE,EAAE;QACpE,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,wBAAwB,GAAG,gCAAgC,CAC9D,IAAI,CAAC,wBAAwB,CAC9B,CAAC;IACJ,CAAC;IAEQ,MAAM;QACb,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAuB,CAAC;QACjD,IAAI,CAAC,wBAAwB,GAAG,EAAE,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAU,QAAQ,CAAC,IAAuB;QAC9C,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AAED,SAAS,gCAAgC,CACvC,KAAkD;IAElD,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,iFAAiF;YACjF,+EAA+E;YAC/E,sDAAsD,CACvD,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,kFAAkF,CACnF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CACjD,CAAC;QACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,iFAAiF;gBACjF,iCAAiC,CAClC,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAoB,CAAC;IACxD,CAAC;IACD,MAAM,IAAI,KAAK,CACb,sFAAsF;QACtF,OAAO,OAAO,KAAK,EAAE,CACtB,CAAC;AACJ,CAAC;AAED,eAAe,aAAa,CAAC"}

package/dist/models/grammar-info.d.ts

@@ -0,0 +1,34 @@
+import { GlossaristModel } from './base.js';
+export type GrammarGender = 'm' | 'f' | 'n' | 'c' | string;
+export type GrammarNumber = 'singular' | 'dual' | 'plural' | string;
+export type GrammarPartOfSpeech = 'noun' | 'verb' | 'adj' | 'adverb' | 'preposition' | 'participle' | string;
+export declare const GRAMMAR_GENDERS: ReadonlyArray<string>;
+export declare const GRAMMAR_NUMBERS: ReadonlyArray<string>;
+export declare const GRAMMAR_PARTS_OF_SPEECH: ReadonlyArray<string>;
+export interface GrammarInfoJson {
+    gender?: GrammarGender | null;
+    number?: GrammarNumber | null;
+    part_of_speech?: GrammarPartOfSpeech | null;
+    partOfSpeech?: GrammarPartOfSpeech | null;
+    noun?: boolean;
+    verb?: boolean;
+    adj?: boolean;
+    adverb?: boolean;
+    preposition?: boolean;
+    participle?: boolean;
+}
+export declare class GrammarInfo extends GlossaristModel {
+    readonly gender: GrammarGender | null;
+    readonly number: GrammarNumber | null;
+    readonly partOfSpeech: GrammarPartOfSpeech | null;
+    readonly noun: boolean;
+    readonly verb: boolean;
+    readonly adj: boolean;
+    readonly adverb: boolean;
+    readonly preposition: boolean;
+    readonly participle: boolean;
+    constructor(data?: GrammarInfoJson);
+    toJSON(): GrammarInfoJson;
+    static fromJSON(data: GrammarInfoJson): GrammarInfo;
+}
+//# sourceMappingURL=grammar-info.d.ts.map

package/dist/models/grammar-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar-info.d.ts","sourceRoot":"","sources":["../../src/models/grammar-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,MAAM,aAAa,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;AAC3D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,MAAM,GACN,KAAK,GACL,QAAQ,GACR,aAAa,GACb,YAAY,GACZ,MAAM,CAAC;AAEX,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,MAAM,CAEhD,CAAC;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,MAAM,CAEhD,CAAC;AACH,eAAO,MAAM,uBAAuB,EAAE,aAAa,CAAC,MAAM,CAExD,CAAC;AAEH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,WAAY,SAAQ,eAAe;IAC9C,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;gBAEjB,IAAI,GAAE,eAAoB;IAa7B,MAAM,IAAI,eAAe;WAclB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW;CAG7D"}

package/dist/models/grammar-info.js

@@ -0,0 +1,59 @@
+import { GlossaristModel } from './base.js';
+export const GRAMMAR_GENDERS = Object.freeze([
+    'm', 'f', 'n', 'c',
+]);
+export const GRAMMAR_NUMBERS = Object.freeze([
+    'singular', 'dual', 'plural',
+]);
+export const GRAMMAR_PARTS_OF_SPEECH = Object.freeze([
+    'noun', 'verb', 'adj', 'adverb', 'preposition', 'participle',
+]);
+export class GrammarInfo extends GlossaristModel {
+    gender;
+    number;
+    partOfSpeech;
+    noun;
+    verb;
+    adj;
+    adverb;
+    preposition;
+    participle;
+    constructor(data = {}) {
+        super();
+        this.gender = data.gender ?? null;
+        this.number = data.number ?? null;
+        this.partOfSpeech = data.part_of_speech ?? data.partOfSpeech ?? null;
+        this.noun = data.noun ?? false;
+        this.verb = data.verb ?? false;
+        this.adj = data.adj ?? false;
+        this.adverb = data.adverb ?? false;
+        this.preposition = data.preposition ?? false;
+        this.participle = data.participle ?? false;
+    }
+    toJSON() {
+        const obj = {};
+        if (this.gender != null)
+            obj.gender = this.gender;
+        if (this.number != null)
+            obj.number = this.number;
+        if (this.partOfSpeech != null)
+            obj.part_of_speech = this.partOfSpeech;
+        if (this.noun)
+            obj.noun = true;
+        if (this.verb)
+            obj.verb = true;
+        if (this.adj)
+            obj.adj = true;
+        if (this.adverb)
+            obj.adverb = true;
+        if (this.preposition)
+            obj.preposition = true;
+        if (this.participle)
+            obj.participle = true;
+        return obj;
+    }
+    static fromJSON(data) {
+        return new GrammarInfo(data);
+    }
+}
+//# sourceMappingURL=grammar-info.js.map

package/dist/models/grammar-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar-info.js","sourceRoot":"","sources":["../../src/models/grammar-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAa5C,MAAM,CAAC,MAAM,eAAe,GAA0B,MAAM,CAAC,MAAM,CAAC;IAClE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CACnB,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,eAAe,GAA0B,MAAM,CAAC,MAAM,CAAC;IAClE,UAAU,EAAE,MAAM,EAAE,QAAQ;CAC7B,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,uBAAuB,GAA0B,MAAM,CAAC,MAAM,CAAC;IAC1E,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY;CAC7D,CAAC,CAAC;AAeH,MAAM,OAAO,WAAY,SAAQ,eAAe;IACrC,MAAM,CAAuB;IAC7B,MAAM,CAAuB;IAC7B,YAAY,CAA6B;IACzC,IAAI,CAAU;IACd,IAAI,CAAU;IACd,GAAG,CAAU;IACb,MAAM,CAAU;IAChB,WAAW,CAAU;IACrB,UAAU,CAAU;IAE7B,YAAY,OAAwB,EAAE;QACpC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;QAC/B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC;IAC7C,CAAC;IAEQ,MAAM;QACb,MAAM,GAAG,GAAoB,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAClD,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAClD,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI;YAAE,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,YAAY,CAAC;QACtE,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAC/B,IAAI,IAAI,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAC/B,IAAI,IAAI,CAAC,GAAG;YAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC;QAC7B,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC;QACnC,IAAI,IAAI,CAAC,WAAW;YAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC;QAC7C,IAAI,IAAI,CAAC,UAAU;YAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;QAC3C,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,CAAU,QAAQ,CAAC,IAAqB;QAC5C,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/models/hyperedge-colors.d.ts

@@ -0,0 +1,19 @@
+import type { ColorPair } from './relation-colors.js';
+export interface ResolveHyperedgeColorOptions {
+    category?: string;
+    overrides?: {
+        byCategory?: Record<string, Partial<ColorPair>>;
+    };
+}
+export interface ResolvedHyperedgeColor {
+    light: string;
+    dark: string;
+    pattern: 'dashed' | 'double' | null;
+}
+interface HyperedgeLike {
+    enumeration?: string;
+    markers?: ReadonlyArray<string>;
+}
+export declare function resolveHyperedgeColor(hyperedge: HyperedgeLike | null, options?: ResolveHyperedgeColorOptions): ResolvedHyperedgeColor | null;
+export {};
+//# sourceMappingURL=hyperedge-colors.d.ts.map

package/dist/models/hyperedge-colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperedge-colors.d.ts","sourceRoot":"","sources":["../../src/models/hyperedge-colors.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAStD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;KAAE,CAAC;CACjE;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;CACrC;AAED,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACjC;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,GAAG,IAAI,EAC/B,OAAO,GAAE,4BAAiC,GACzC,sBAAsB,GAAG,IAAI,CAe/B"}

package/dist/models/hyperedge-colors.js

@@ -0,0 +1,61 @@
+// Hyperedge color resolver — resolves display colors for a
+// PartitiveHyperedge based on its enumeration and the carrying
+// concept's category color.
+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] ?? 255) - 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),
+    ];
+}
+//# sourceMappingURL=hyperedge-colors.js.map

package/dist/models/hyperedge-colors.js.map

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

package/dist/models/hyperedge-index.d.ts

@@ -0,0 +1,34 @@
+import type { AbstractHyperedge } from './abstract-hyperedge.js';
+interface HyperedgeLike {
+    comprehensive?: {
+        source?: string | null;
+        id?: string | null;
+    } | null;
+    members?: ReadonlyArray<{
+        ref?: {
+            source?: string | null;
+            id?: string | null;
+        } | null;
+    }>;
+}
+export declare class HyperedgeIndex {
+    private readonly _byComprehensive;
+    private readonly _byMember;
+    constructor(hyperedges?: ReadonlyArray<HyperedgeLike>);
+    forComprehensive(qualifiedId: string): HyperedgeLike[];
+    forMember(qualifiedId: string): HyperedgeLike[];
+    comprehensives(): string[];
+    members(): string[];
+    get size(): number;
+}
+/**
+ * Build a HyperedgeIndex across multiple Concepts' relations arrays
+ * (a dataset-wide view). Each Concept contributes its own .relations.
+ * Helper for the most common pattern: index once at collection load,
+ * query many times.
+ */
+export declare function buildDatasetIndex(concepts?: ReadonlyArray<{
+    relations?: ReadonlyArray<AbstractHyperedge | HyperedgeLike>;
+}>): HyperedgeIndex;
+export {};
+//# sourceMappingURL=hyperedge-index.d.ts.map

package/dist/models/hyperedge-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperedge-index.d.ts","sourceRoot":"","sources":["../../src/models/hyperedge-index.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,UAAU,aAAa;IACrB,aAAa,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACtE,OAAO,CAAC,EAAE,aAAa,CAAC;QAAE,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC1F;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA+B;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;gBAE7C,UAAU,GAAE,aAAa,CAAC,aAAa,CAAM;IAgBzD,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE;IAKtD,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE;IAK/C,cAAc,IAAI,MAAM,EAAE;IAK1B,OAAO,IAAI,MAAM,EAAE;IAInB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,GAAE,aAAa,CAAC;IAAE,SAAS,CAAC,EAAE,aAAa,CAAC,iBAAiB,GAAG,aAAa,CAAC,CAAA;CAAE,CAAM,GAC7F,cAAc,CAQhB"}

package/dist/models/hyperedge-index.js

@@ -0,0 +1,85 @@
+// HyperedgeIndex — directional index over a hyperedge set.
+//
+// A hyperedge is 1→N (one comprehensive, many members). The forward
+// query ("which hyperedges have X as comprehensive?") and the reverse
+// query ("which hyperedges have Y as a member?") are both useful. The
+// reverse query is the load-bearing one: OIML V 2-200:2010 concept
+// 5.13 is a member of one of 5.1's hyperedges AND the comprehensive
+// of its own 2 hyperedges — without an index, every "find hyperedges
+// mentioning X" turns into an O(N) walk over every hyperedge.
+//
+// The index is built on demand from a flat hyperedge list (typically
+// Concept.relations or the union of all concepts' relations in a
+// collection). It does not store state on Concept — Concept stays a
+// simple value object.
+//
+// Identity key matches HyperedgeRegistry / ConceptRef conventions:
+//   `${source}:${id}`   (empty source or id is rejected)
+export class HyperedgeIndex {
+    _byComprehensive;
+    _byMember;
+    constructor(hyperedges = []) {
+        this._byComprehensive = new Map();
+        this._byMember = new Map();
+        for (const h of hyperedges) {
+            const cKey = _qualifiedId(h?.comprehensive);
+            if (cKey)
+                _addToMapList(this._byComprehensive, cKey, h);
+            const members = Array.isArray(h?.members) ? h.members : [];
+            for (const m of members) {
+                const mKey = _qualifiedId(m?.ref ?? m);
+                if (mKey)
+                    _addToMapList(this._byMember, mKey, h);
+            }
+        }
+    }
+    // Hyperedges where the given concept is the comprehensive (the "1" side).
+    forComprehensive(qualifiedId) {
+        return this._byComprehensive.get(qualifiedId) ?? [];
+    }
+    // Hyperedges where the given concept appears as a member (the "many" side).
+    forMember(qualifiedId) {
+        return this._byMember.get(qualifiedId) ?? [];
+    }
+    // All concepts that appear as a comprehensive in any indexed hyperedge.
+    comprehensives() {
+        return [...this._byComprehensive.keys()];
+    }
+    // All concepts that appear as a member in any indexed hyperedge.
+    members() {
+        return [...this._byMember.keys()];
+    }
+    get size() {
+        return this._byComprehensive.size;
+    }
+}
+/**
+ * Build a HyperedgeIndex across multiple Concepts' relations arrays
+ * (a dataset-wide view). Each Concept contributes its own .relations.
+ * Helper for the most common pattern: index once at collection load,
+ * query many times.
+ */
+export function buildDatasetIndex(concepts = []) {
+    const all = [];
+    for (const concept of concepts) {
+        for (const h of concept.relations ?? []) {
+            all.push(h);
+        }
+    }
+    return new HyperedgeIndex(all);
+}
+function _qualifiedId(ref) {
+    if (!ref)
+        return null;
+    const source = ref.source ?? '';
+    const id = ref.id ?? '';
+    if (!source && !id)
+        return null;
+    return `${source}:${id}`;
+}
+function _addToMapList(map, key, value) {
+    if (!map.has(key))
+        map.set(key, []);
+    map.get(key)?.push(value);
+}
+//# sourceMappingURL=hyperedge-index.js.map

package/dist/models/hyperedge-index.js.map

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

package/dist/models/hyperedge-member.d.ts

@@ -0,0 +1,28 @@
+import { GlossaristModel } from './base.js';
+import { ConceptRef } from './concept-ref.js';
+import type { ConceptRefJson } from './concept-ref.js';
+import type { PartitivePresence } from './partitive-presence.js';
+import type { PartitiveCount } from './partitive-count.js';
+export interface HyperedgeMemberJson {
+    ref?: ConceptRefJson | ConceptRef;
+    presence?: PartitivePresence;
+    count?: PartitiveCount;
+}
+export declare abstract class HyperedgeMember extends GlossaristModel {
+    readonly ref: ConceptRef;
+    readonly presence: PartitivePresence;
+    readonly count: PartitiveCount;
+    constructor(data?: HyperedgeMemberJson);
+    get isRequired(): boolean;
+    get isOptional(): boolean;
+    identity(): string;
+    toJSON(): HyperedgeMemberJson;
+    static identityOf(value: {
+        ref?: {
+            source?: string | null;
+            id?: string | null;
+        } | null;
+    } | null | undefined): string;
+    static fromJSON(_data: HyperedgeMemberJson): HyperedgeMember;
+}
+//# sourceMappingURL=hyperedge-member.d.ts.map

package/dist/models/hyperedge-member.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperedge-member.d.ts","sourceRoot":"","sources":["../../src/models/hyperedge-member.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC;IAClC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED,8BAAsB,eAAgB,SAAQ,eAAe;IAC3D,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;gBAEnB,IAAI,GAAE,mBAAwB;IAS1C,IAAI,UAAU,IAAI,OAAO,CAAyC;IAClE,IAAI,UAAU,IAAI,OAAO,CAAyC;IAEzD,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,mBAAmB;IAOtC,MAAM,CAAC,UAAU,CACf,KAAK,EAAE;QAAE,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,GACxF,MAAM;WAMO,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,eAAe;CAStE"}

package/dist/models/hyperedge-member.js

@@ -0,0 +1,92 @@
+// HyperedgeMember — abstract base shape for the members of any directed
+// 1→N hyperedge (PartitiveMember, GenericMember, future AssociativeMember,
+// SequentialMember).
+//
+// Carries ONLY the dimensions shared by every hyperedge member type:
+//   ref       — ConceptRef [1] (the member concept)
+//   presence  — 'required' | 'optional' (default: required)
+//   count     — 'exactly_one' | 'at_least_one' | 'multiple' (default: exactly_one)
+//
+// These three form the ISO 704:2022 MECE pair (presence × count). The
+// pair is the shared invariant across all hyperedge types — that's
+// why it lives on the base.
+//
+// Type-specific extensions live on the leaves:
+//   PartitiveMember  — is_delimiting (rake-diagram semantics, ISO 704 §5.5.4.2.2)
+//   GenericMember    — delimitingCharacteristic (intension difference, ISO 704 §5.5.4.2.1)
+//
+// See docs/design/abstract-hyperedge.md (concept-model repo).
+import { GlossaristModel } from './base.js';
+import { ConceptRef } from './concept-ref.js';
+import { PARTITIVE_PRESENCE_VALUES, DEFAULT_PRESENCE, isValidPresence } from './partitive-presence.js';
+import { PARTITIVE_COUNT_VALUES, DEFAULT_COUNT, isValidCount } from './partitive-count.js';
+import { multiplicityFromPair } from './multiplicity.js';
+export class HyperedgeMember extends GlossaristModel {
+    ref;
+    presence;
+    count;
+    constructor(data = {}) {
+        super();
+        this.ref = _ensureRef(data.ref);
+        this.presence = _resolvePresence(data.presence);
+        this.count = _resolveCount(data.count);
+        _assertValidPair(this.presence, this.count);
+    }
+    get isRequired() { return this.presence === 'required'; }
+    get isOptional() { return this.presence === 'optional'; }
+    identity() {
+        return HyperedgeMember.identityOf(this);
+    }
+    toJSON() {
+        const obj = { ref: this.ref.toJSON() };
+        if (this.presence !== DEFAULT_PRESENCE)
+            obj.presence = this.presence;
+        if (this.count !== DEFAULT_COUNT)
+            obj.count = this.count;
+        return obj;
+    }
+    static identityOf(value) {
+        const v = value ?? {};
+        const ref = v.ref ?? {};
+        return `${ref.source ?? ''}:${ref.id ?? ''}`;
+    }
+    static fromJSON(_data) {
+        // Abstract base — subclasses MUST override. The base
+        // implementation is a typed marker that dispatches to the wrong
+        // class would surface as a runtime error rather than silently
+        // returning a mis-typed instance.
+        throw new Error('HyperedgeMember.fromJSON must be overridden by a subclass');
+    }
+}
+function _ensureRef(value) {
+    const ref = value instanceof ConceptRef ? value : new ConceptRef(value ?? {});
+    if (!ref.source && !ref.id && !ref.text) {
+        throw new Error('HyperedgeMember.ref must be a non-empty ConceptRef ' +
+            '(source, id, or text required)');
+    }
+    return ref;
+}
+function _resolvePresence(value) {
+    const p = value ?? DEFAULT_PRESENCE;
+    if (!isValidPresence(p)) {
+        throw new Error(`invalid presence ${JSON.stringify(value)}; ` +
+            `must be one of: ${PARTITIVE_PRESENCE_VALUES.join(', ')}`);
+    }
+    return p;
+}
+function _resolveCount(value) {
+    const c = value ?? DEFAULT_COUNT;
+    if (!isValidCount(c)) {
+        throw new Error(`invalid count ${JSON.stringify(value)}; ` +
+            `must be one of: ${PARTITIVE_COUNT_VALUES.join(', ')}`);
+    }
+    return c;
+}
+function _assertValidPair(presence, count) {
+    // Delegate to the multiplicity SSOT. The canonical error string
+    // lives in one place: multiplicity.ts. Calling multiplicityFromPair
+    // throws on the invalid combination; we don't need to duplicate the
+    // error message here.
+    multiplicityFromPair(presence, count);
+}
+//# sourceMappingURL=hyperedge-member.js.map

package/dist/models/hyperedge-member.js.map

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