glossarist 0.4.49 → 0.4.51

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":"AAAA,wEAAwE;AACxE,2EAA2E;AAC3E,qBAAqB;AACrB,EAAE;AACF,qEAAqE;AACrE,oDAAoD;AACpD,4DAA4D;AAC5D,mFAAmF;AACnF,EAAE;AACF,sEAAsE;AACtE,mEAAmE;AACnE,4BAA4B;AAC5B,EAAE;AACF,+CAA+C;AAC/C,kFAAkF;AAClF,2FAA2F;AAC3F,EAAE;AACF,8DAA8D;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,yBAAyB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEvG,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAQzD,MAAM,OAAgB,eAAgB,SAAQ,eAAe;IAClD,GAAG,CAAa;IAChB,QAAQ,CAAoB;IAC5B,KAAK,CAAiB;IAE/B,YAAY,OAA4B,EAAE;QACxC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEvC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,UAAU,KAAc,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC;IAClE,IAAI,UAAU,KAAc,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC;IAEzD,QAAQ;QACf,OAAO,eAAe,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAEQ,MAAM;QACb,MAAM,GAAG,GAAwB,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;QAC5D,IAAI,IAAI,CAAC,QAAQ,KAAK,gBAAgB;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QACrE,IAAI,IAAI,CAAC,KAAK,KAAK,aAAa;YAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,CAAC,UAAU,CACf,KAAyF;QAEzF,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;QACxB,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,CAAU,QAAQ,CAAC,KAA0B;QACjD,qDAAqD;QACrD,gEAAgE;QAChE,8DAA8D;QAC9D,kCAAkC;QAClC,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;IACJ,CAAC;CACF;AAED,SAAS,UAAU,CAAC,KAAqD;IACvE,MAAM,GAAG,GAAG,KAAK,YAAY,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC9E,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,qDAAqD;YACrD,gCAAgC,CACjC,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA2C;IACnE,MAAM,CAAC,GAAG,KAAK,IAAI,gBAAgB,CAAC;IACpC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI;YAC7C,mBAAmB,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1D,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,aAAa,CAAC,KAAwC;IAC7D,MAAM,CAAC,GAAG,KAAK,IAAI,aAAa,CAAC;IACjC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI;YAC1C,mBAAmB,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,gBAAgB,CAAC,QAA2B,EAAE,KAAqB;IAC1E,gEAAgE;IAChE,oEAAoE;IACpE,oEAAoE;IACpE,sBAAsB;IACtB,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,47 @@
+import type { AbstractHyperedge } from './abstract-hyperedge.js';
+/**
+ * Shape a registered hyperedge class must satisfy. Every leaf class
+ * in src/models/ matches this shape (declared as static fields).
+ */
+export interface HyperedgeClass {
+    readonly wireKey: string;
+    readonly typeTag: string;
+    readonly rdfType: string;
+    readonly memberClass: new (...args: never[]) => unknown;
+    readonly v1WireKeys?: ReadonlyArray<string>;
+    readonly kindLabel?: string;
+    readonly name: string;
+}
+declare class HyperedgeRegistry {
+    static _byWireKey: Map<string, HyperedgeClass>;
+    static _byTypeTag: Map<string, HyperedgeClass>;
+    static _byRdfType: Map<string, HyperedgeClass>;
+    static register(cls: HyperedgeClass | undefined): boolean;
+    /**
+     * Test-only. Removes a class from all three indexes. Used by the OCP
+     * spec to clean up mock types it adds during a test run.
+     */
+    static unregister(cls: HyperedgeClass | undefined): boolean;
+    static forWireKey(key: string): HyperedgeClass | null;
+    static forTypeTag(tag: string): HyperedgeClass | null;
+    static forRdfType(type: string): HyperedgeClass | null;
+    static allClasses(): HyperedgeClass[];
+    static allWireKeys(): string[];
+    static allTypeTags(): string[];
+    /**
+     * Snapshot of every registered wire-shape identifier (v2 wireKey plus
+     * any v1 legacy keys). Used by the parser to reserve STRUCTURAL_KEYS
+     * and to know which top-level YAML keys to walk for hyperedge data.
+     */
+    static allWireAndLegacyKeys(): string[];
+}
+/**
+ * Helper: partition a unified hyperedge array by wire key. Used by
+ * Concept.toJSON, ConceptSerializer, and diff-patch to emit per-type
+ * wire keys without per-type branching in those files. Adding a new
+ * hyperedge type "just works" because the group is keyed by the
+ * class's static wireKey.
+ */
+export declare function groupHyperedgesByWireKey(hyperedges: ReadonlyArray<AbstractHyperedge> | null | undefined): Record<string, AbstractHyperedge[]>;
+export { HyperedgeRegistry };
+//# sourceMappingURL=hyperedge-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hyperedge-registry.d.ts","sourceRoot":"","sources":["../../src/models/hyperedge-registry.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC;IACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,cAAM,iBAAiB;IACrB,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IAC3D,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IAC3D,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IAE3D,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO;IA2BzD;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS,GAAG,OAAO;IAQ3D,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAGrD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAGrD,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAItD,MAAM,CAAC,UAAU,IAAI,cAAc,EAAE;IAarC,MAAM,CAAC,WAAW,IAAI,MAAM,EAAE;IAC9B,MAAM,CAAC,WAAW,IAAI,MAAM,EAAE;IAE9B;;;;OAIG;IACH,MAAM,CAAC,oBAAoB,IAAI,MAAM,EAAE;CAQxC;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,aAAa,CAAC,iBAAiB,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9D,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CASrC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/models/hyperedge-registry.js

@@ -0,0 +1,118 @@
+// HyperedgeRegistry — single source of truth for hyperedge type dispatch.
+//
+// Each hyperedge leaf class (PartitiveHyperedge, GenericHyperedge, future
+// TemporalHyperedge, AssociativeHyperedge, etc.) registers itself once at
+// module load. External systems (parser, serializer, diff, RDF emitter,
+// validators) read from this registry instead of branching on instanceof
+// or hardcoding per-type tables.
+//
+// Adding a new hyperedge type:
+//   1. Declare the leaf class with the 6-field metadata block
+//      (wireKey, typeTag, rdfType, memberClass, v1WireKeys, kindLabel).
+//   2. Call HyperedgeRegistry.register(MyClass) at the bottom of the file.
+//
+// Nothing else in the codebase changes. That is the OCP contract.
+//
+// Three indexes support three lookup patterns:
+//   byWireKey  — parser/serializer/diff-patch dispatch by YAML/JSON key
+//   byTypeTag  — per-file loader dispatch by `type: ...` discriminator
+//   byRdfType  — RDF emitter dispatch by ontology class IRI
+//
+// The abstract base (AbstractHyperedge) has no wireKey and is skipped
+// by register() — it cannot be instantiated through the registry.
+class HyperedgeRegistry {
+    static _byWireKey = new Map();
+    static _byTypeTag = new Map();
+    static _byRdfType = new Map();
+    static register(cls) {
+        if (!cls || !cls.wireKey || !cls.typeTag || !cls.rdfType)
+            return false;
+        if (this._byWireKey.has(cls.wireKey)) {
+            throw new Error(`HyperedgeRegistry: duplicate wireKey '${cls.wireKey}' ` +
+                `(trying to register ${cls.name}; already registered to ` +
+                `${this._byWireKey.get(cls.wireKey)?.name})`);
+        }
+        if (this._byTypeTag.has(cls.typeTag)) {
+            throw new Error(`HyperedgeRegistry: duplicate typeTag '${cls.typeTag}' ` +
+                `(trying to register ${cls.name})`);
+        }
+        if (this._byRdfType.has(cls.rdfType)) {
+            throw new Error(`HyperedgeRegistry: duplicate rdfType '${cls.rdfType}' ` +
+                `(trying to register ${cls.name})`);
+        }
+        this._byWireKey.set(cls.wireKey, cls);
+        this._byTypeTag.set(cls.typeTag, cls);
+        this._byRdfType.set(cls.rdfType, cls);
+        return true;
+    }
+    /**
+     * Test-only. Removes a class from all three indexes. Used by the OCP
+     * spec to clean up mock types it adds during a test run.
+     */
+    static unregister(cls) {
+        if (!cls)
+            return false;
+        const r1 = this._byWireKey.delete(cls.wireKey);
+        const r2 = this._byTypeTag.delete(cls.typeTag);
+        const r3 = this._byRdfType.delete(cls.rdfType);
+        return r1 || r2 || r3;
+    }
+    static forWireKey(key) {
+        return this._byWireKey.get(key) ?? null;
+    }
+    static forTypeTag(tag) {
+        return this._byTypeTag.get(tag) ?? null;
+    }
+    static forRdfType(type) {
+        return this._byRdfType.get(type) ?? null;
+    }
+    static allClasses() {
+        // Dedup in case the same class is reachable via multiple indexes.
+        const seen = new Set();
+        const out = [];
+        for (const cls of this._byTypeTag.values()) {
+            if (!seen.has(cls)) {
+                seen.add(cls);
+                out.push(cls);
+            }
+        }
+        return out;
+    }
+    static allWireKeys() { return [...this._byWireKey.keys()]; }
+    static allTypeTags() { return [...this._byTypeTag.keys()]; }
+    /**
+     * Snapshot of every registered wire-shape identifier (v2 wireKey plus
+     * any v1 legacy keys). Used by the parser to reserve STRUCTURAL_KEYS
+     * and to know which top-level YAML keys to walk for hyperedge data.
+     */
+    static allWireAndLegacyKeys() {
+        const out = [];
+        for (const cls of this.allClasses()) {
+            out.push(cls.wireKey);
+            for (const k of cls.v1WireKeys ?? [])
+                out.push(k);
+        }
+        return out;
+    }
+}
+/**
+ * Helper: partition a unified hyperedge array by wire key. Used by
+ * Concept.toJSON, ConceptSerializer, and diff-patch to emit per-type
+ * wire keys without per-type branching in those files. Adding a new
+ * hyperedge type "just works" because the group is keyed by the
+ * class's static wireKey.
+ */
+export function groupHyperedgesByWireKey(hyperedges) {
+    const out = {};
+    for (const h of hyperedges ?? []) {
+        const key = h?.constructor?.wireKey;
+        if (!key)
+            continue;
+        if (!out[key])
+            out[key] = [];
+        out[key].push(h);
+    }
+    return out;
+}
+export { HyperedgeRegistry };
+//# sourceMappingURL=hyperedge-registry.js.map

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

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