glossarist 0.4.50 → 0.4.52

package/dist/models/relation-categories.js

@@ -0,0 +1,135 @@
+// Categorization SSOT for the 52 glossarist relationship types.
+import { RELATIONSHIP_TYPES } from './related-concept.js';
+/**
+ * Each type in RELATIONSHIP_TYPES belongs to exactly one category. The
+ * categories mirror the concept-model taxonomy. Adding a new type
+ * means adding a taxonomy entry — no code changes here.
+ */
+export const RELATION_CATEGORIES = Object.freeze({
+    lifecycle: Object.freeze({
+        label: 'Lifecycle',
+        description: 'Concept lifecycle transitions: supersession, deprecation, replacement.',
+        types: Object.freeze([
+            'deprecates', 'deprecated_by',
+            'supersedes', 'superseded_by',
+            'replaces', 'replaced_by',
+            'invalidates', 'invalidated_by',
+            'retires', 'retired_by',
+        ]),
+    }),
+    hierarchical: Object.freeze({
+        label: 'Hierarchical',
+        description: 'Broader/narrower relations, including SKOS and ISO 25964 generic/partitive/instantial.',
+        types: Object.freeze([
+            'broader', 'narrower',
+            'broader_generic', 'narrower_generic',
+            'broader_partitive', 'narrower_partitive',
+            'broader_instantial', 'narrower_instantial',
+        ]),
+    }),
+    associative: Object.freeze({
+        label: 'Associative',
+        description: 'Generic see-also references between concepts.',
+        types: Object.freeze([
+            'see', 'related_concept',
+            'related_concept_broader', 'related_concept_narrower',
+            'references',
+        ]),
+    }),
+    comparative: Object.freeze({
+        label: 'Comparative',
+        description: 'Compare / contrast relations between concepts.',
+        types: Object.freeze(['compare', 'contrast']),
+    }),
+    spatiotemporal: Object.freeze({
+        label: 'Spatiotemporal',
+        description: 'Sequential, spatial, and temporal relations.',
+        types: Object.freeze([
+            'sequentially_related_concept',
+            'spatially_related_concept',
+            'temporally_related_concept',
+        ]),
+    }),
+    lexical: Object.freeze({
+        label: 'Lexical',
+        description: 'Lexical relations between designations across languages.',
+        types: Object.freeze(['homograph', 'false_friend']),
+    }),
+    mapping: Object.freeze({
+        label: 'Mapping',
+        description: 'SKOS mapping properties for cross-vocabulary alignment.',
+        types: Object.freeze([
+            'equivalent', 'close_match',
+            'broad_match', 'narrow_match', 'related_match',
+        ]),
+    }),
+    definitional: Object.freeze({
+        label: 'Definitional',
+        description: 'ISO 19135 concept-to-concept relations: definition, part, instance, inheritance, versioning.',
+        types: Object.freeze([
+            'has_concept', 'is_concept_of',
+            'instance_of', 'has_instance',
+            'has_definition', 'definition_of',
+            'has_part', 'is_part_of',
+            'inherits', 'inherited_by',
+            'has_version', 'version_of',
+            'current_version', 'current_version_of',
+            'provides', 'provided_by',
+        ]),
+    }),
+});
+const _CATEGORY_BY_TYPE = (() => {
+    const map = new Map();
+    for (const [cat, def] of Object.entries(RELATION_CATEGORIES)) {
+        for (const t of def.types)
+            map.set(t, cat);
+    }
+    return map;
+})();
+const _CATEGORY_ALIASES = {
+    conceptInstance: 'definitional',
+    versioning: 'definitional',
+};
+/**
+ * Returns the category key for the given relationship type, or null
+ * when the type is not categorized.
+ */
+export function categoryOf(type) {
+    return _CATEGORY_BY_TYPE.get(type) ?? null;
+}
+/**
+ * Returns the category definition for the given category key.
+ * Accepts both canonical names (definitional) and aliases from
+ * earlier glossarist-js versions.
+ */
+export function categoryDefinition(categoryKey) {
+    const canonical = _CATEGORY_ALIASES[categoryKey] ?? categoryKey;
+    return RELATION_CATEGORIES[canonical] ?? null;
+}
+/**
+ * MECE sanity check. Returns the list of relationship types that are
+ * NOT categorized.
+ */
+export function uncategorizedTypes() {
+    return RELATIONSHIP_TYPES.filter((t) => !_CATEGORY_BY_TYPE.has(t));
+}
+/**
+ * MECE sanity check. Returns a list of { type, count } entries for any
+ * type that appears in MORE than one category.
+ */
+export function duplicatedTypes() {
+    const counts = new Map();
+    for (const def of Object.values(RELATION_CATEGORIES)) {
+        for (const t of def.types) {
+            counts.set(t, (counts.get(t) ?? 0) + 1);
+        }
+    }
+    const out = [];
+    for (const [type, count] of counts) {
+        if (count > 1)
+            out.push({ type, count });
+    }
+    return out;
+}
+export { RELATION_CATEGORIES as RELATION_CATEGORIES_READONLY, };
+//# sourceMappingURL=relation-categories.js.map

package/dist/models/relation-categories.js.map

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

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

@@ -0,0 +1,35 @@
+export interface ColorPair {
+    light: string;
+    dark: string;
+}
+export interface RelationColorPalette {
+    byCategory: Readonly<Record<string, ColorPair>>;
+    byType: Readonly<Record<string, ColorPair>>;
+}
+export interface ResolveRelationColorOptions {
+    overrides?: Partial<RelationColorPalette>;
+    mode?: 'light' | 'dark';
+}
+/**
+ * One { light, dark } pair per category. Keeping these in glossarist-js
+ * lets the defaults ship with the library; consumers only need to
+ * customize when they want to deviate.
+ */
+export declare const RELATION_COLOR_DEFAULTS: RelationColorPalette;
+/**
+ * Resolves the color for a relationship type. Resolution order:
+ *   1. overrides.byType[type]
+ *   2. RELATION_COLOR_DEFAULTS.byType[type]
+ *   3. overrides.byCategory[category]
+ *   4. RELATION_COLOR_DEFAULTS.byCategory[category]
+ *   5. null (uncategorized or unrecognized type)
+ */
+export declare function resolveRelationColor(type: string, options?: ResolveRelationColorOptions): string | null;
+/**
+ * Returns the { light, dark } pair for a category, merging overrides
+ * over defaults. Useful for UIs that want to render a legend.
+ */
+export declare function categoryColorPair(categoryKey: string, overrides?: {
+    byCategory?: Record<string, Partial<ColorPair>>;
+}): ColorPair | null;
+//# sourceMappingURL=relation-colors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relation-colors.d.ts","sourceRoot":"","sources":["../../src/models/relation-colors.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAChD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,oBAYpC,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,2BAAgC,GACxC,MAAM,GAAG,IAAI,CAcf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;CAAO,GAClE,SAAS,GAAG,IAAI,CAOlB"}

package/dist/models/relation-colors.js

@@ -0,0 +1,68 @@
+// Default color palette for relation categories and individual types.
+//
+// The defaults mirror concept-browser/data/colors.json. Per-deployment
+// overrides pass through resolveRelationColor(type, { overrides, mode })
+// and take precedence over category defaults.
+import { categoryOf, categoryDefinition } from './relation-categories.js';
+/**
+ * One { light, dark } pair per category. Keeping these in glossarist-js
+ * lets the defaults ship with the library; consumers only need to
+ * customize when they want to deviate.
+ */
+export const RELATION_COLOR_DEFAULTS = Object.freeze({
+    byCategory: Object.freeze({
+        lifecycle: { light: '#B43A2E', dark: '#F87171' },
+        hierarchical: { light: '#1F6FEB', dark: '#6EA8FE' },
+        associative: { light: '#6B7280', dark: '#9CA3AF' },
+        comparative: { light: '#A855F7', dark: '#C4B5FD' },
+        spatiotemporal: { light: '#0D9488', dark: '#5EEAD4' },
+        lexical: { light: '#D97706', dark: '#FBBF24' },
+        mapping: { light: '#2563EB', dark: '#93BBFD' },
+        definitional: { light: '#65A30D', dark: '#A3E635' },
+    }),
+    byType: Object.freeze({}),
+});
+/**
+ * Resolves the color for a relationship type. Resolution order:
+ *   1. overrides.byType[type]
+ *   2. RELATION_COLOR_DEFAULTS.byType[type]
+ *   3. overrides.byCategory[category]
+ *   4. RELATION_COLOR_DEFAULTS.byCategory[category]
+ *   5. null (uncategorized or unrecognized type)
+ */
+export function resolveRelationColor(type, options = {}) {
+    const mode = options.mode ?? 'light';
+    const overrides = options.overrides ?? {};
+    const typeOverride = overrides.byType?.[type] ?? RELATION_COLOR_DEFAULTS.byType[type];
+    if (typeOverride)
+        return pickMode(typeOverride, mode);
+    const category = categoryOf(type);
+    if (!category)
+        return null;
+    const categoryOverride = overrides.byCategory?.[category] ?? RELATION_COLOR_DEFAULTS.byCategory[category];
+    if (!categoryOverride)
+        return null;
+    return pickMode(categoryOverride, mode);
+}
+/**
+ * Returns the { light, dark } pair for a category, merging overrides
+ * over defaults. Useful for UIs that want to render a legend.
+ */
+export function categoryColorPair(categoryKey, overrides = {}) {
+    const def = categoryDefinition(categoryKey);
+    if (!def)
+        return null;
+    const fromOverride = overrides.byCategory?.[categoryKey];
+    const fromDefault = RELATION_COLOR_DEFAULTS.byCategory[categoryKey];
+    if (!fromDefault && !fromOverride)
+        return null;
+    return { ...(fromDefault ?? { light: '', dark: '' }), ...(fromOverride ?? {}) };
+}
+function pickMode(pair, mode) {
+    if (pair == null)
+        return null;
+    if (typeof pair === 'string')
+        return pair;
+    return pair[mode] ?? pair.light ?? pair.dark ?? null;
+}
+//# sourceMappingURL=relation-colors.js.map

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

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

package/dist/models/relation-loader.d.ts

@@ -0,0 +1,41 @@
+import type { AbstractHyperedge } from './abstract-hyperedge.js';
+/**
+ * Backward-compat: snapshot of registered classes keyed by typeTag.
+ * Prefer HyperedgeRegistry.forTypeTag() for new code — this snapshot
+ * is frozen at module load and won't pick up runtime registrations
+ * from tests (the OCP test in Phase 11 registers a mock type after
+ * import).
+ */
+export declare const TYPE_TO_CLASS: object;
+/**
+ * Thrown by `loadAll` when a relation file has an unknown `type`,
+ * malformed structure, or a class that fails to instantiate.
+ */
+export declare class RelationLoadError extends Error {
+    readonly path: string;
+    constructor(path: string, message: string);
+}
+/**
+ * Walk a `relations/` directory and load every relation file,
+ * returning a Map keyed by comprehensive-id.
+ *
+ * Returns an empty Map if `relationsDir` doesn't exist or is empty.
+ */
+export declare function loadAll(relationsDir: string | null | undefined): Map<string, AbstractHyperedge[]>;
+/**
+ * Namespace bundle for the loader — callers import it as
+ * `import { RelationLoader } from './relation-loader.js'` and call
+ * `RelationLoader.loadAll(dir)`. The individual functions are also
+ * exported directly for tree-shakeable single-call sites.
+ */
+export declare const RelationLoader: Readonly<{
+    loadAll: typeof loadAll;
+    loadOne: typeof loadOne;
+}>;
+/**
+ * Load a single relation file. Returns null if the file is missing,
+ * unreadable, or doesn't have a recognized `type` field. Throws
+ * `RelationLoadError` on malformed content.
+ */
+export declare function loadOne(path: string): AbstractHyperedge | null;
+//# sourceMappingURL=relation-loader.d.ts.map

package/dist/models/relation-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-loader.d.ts","sourceRoot":"","sources":["../../src/models/relation-loader.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAWjE;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,QAazB,CAAC;AAEF;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI1C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAqBlC;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;EAAsC,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAa9D"}

package/dist/models/relation-loader.js

@@ -0,0 +1,101 @@
+// HyperedgeLoader — runtime loader for per-file hyperedge YAMLs.
+//
+// Walks a `relations/<comprehensive-id>/<slug>.yaml` directory and
+// dispatches each file to the appropriate class (PartitiveHyperedge,
+// GenericHyperedge, future leaves) based on its `type` field, via
+// HyperedgeRegistry.
+import { readdirSync, readFileSync, existsSync } from 'node:fs';
+import * as yaml from 'js-yaml';
+import { HyperedgeRegistry } from './hyperedge-registry.js';
+/**
+ * Backward-compat: snapshot of registered classes keyed by typeTag.
+ * Prefer HyperedgeRegistry.forTypeTag() for new code — this snapshot
+ * is frozen at module load and won't pick up runtime registrations
+ * from tests (the OCP test in Phase 11 registers a mock type after
+ * import).
+ */
+export const TYPE_TO_CLASS = new Proxy({}, {
+    get(_target, prop) {
+        return typeof prop === 'string' ? HyperedgeRegistry.forTypeTag(prop) : null;
+    },
+    ownKeys() {
+        return HyperedgeRegistry.allTypeTags();
+    },
+    getOwnPropertyDescriptor() {
+        return { enumerable: true, configurable: true };
+    },
+});
+/**
+ * Thrown by `loadAll` when a relation file has an unknown `type`,
+ * malformed structure, or a class that fails to instantiate.
+ */
+export class RelationLoadError extends Error {
+    path;
+    constructor(path, message) {
+        super(`relation-loader: ${path}: ${message}`);
+        this.path = path;
+    }
+}
+/**
+ * Walk a `relations/` directory and load every relation file,
+ * returning a Map keyed by comprehensive-id.
+ *
+ * Returns an empty Map if `relationsDir` doesn't exist or is empty.
+ */
+export function loadAll(relationsDir) {
+    const result = new Map();
+    if (!relationsDir)
+        return result;
+    if (!existsSync(relationsDir))
+        return result;
+    const entries = readdirSync(relationsDir, { withFileTypes: true });
+    for (const compEntry of entries) {
+        if (!compEntry.isDirectory())
+            continue;
+        const compId = compEntry.name;
+        const compDir = `${relationsDir}/${compId}`;
+        if (!result.has(compId))
+            result.set(compId, []);
+        const files = readdirSync(compDir)
+            .filter((f) => f.endsWith('.yaml') || f.endsWith('.yml'))
+            .sort();
+        for (const file of files) {
+            const path = `${compDir}/${file}`;
+            const rel = loadOne(path);
+            if (rel)
+                result.get(compId)?.push(rel);
+        }
+    }
+    return result;
+}
+/**
+ * Namespace bundle for the loader — callers import it as
+ * `import { RelationLoader } from './relation-loader.js'` and call
+ * `RelationLoader.loadAll(dir)`. The individual functions are also
+ * exported directly for tree-shakeable single-call sites.
+ */
+export const RelationLoader = Object.freeze({ loadAll, loadOne });
+/**
+ * Load a single relation file. Returns null if the file is missing,
+ * unreadable, or doesn't have a recognized `type` field. Throws
+ * `RelationLoadError` on malformed content.
+ */
+export function loadOne(path) {
+    let doc;
+    try {
+        doc = yaml.load(readFileSync(path, 'utf8'));
+    }
+    catch (e) {
+        throw new RelationLoadError(path, `YAML parse failed: ${e.message}`);
+    }
+    if (!doc || typeof doc !== 'object')
+        return null;
+    const d = doc;
+    if (!d.type)
+        return null;
+    const Cls = HyperedgeRegistry.forTypeTag(d.type);
+    if (!Cls)
+        return null;
+    return Cls.fromJSON(d);
+}
+//# sourceMappingURL=relation-loader.js.map

package/dist/models/relation-loader.js.map

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

package/dist/models/section.d.ts

@@ -0,0 +1,22 @@
+import { GlossaristModel } from './base.js';
+import type { LocalizedString } from './generic-member.js';
+export declare const ORDERING_METHODS: ReadonlyArray<string>;
+export type OrderingMethod = string;
+export interface SectionJson {
+    id?: string | null;
+    names?: LocalizedString;
+    ordering?: OrderingMethod | null;
+    children?: ReadonlyArray<SectionJson | Section>;
+}
+export declare class Section extends GlossaristModel {
+    readonly id: string | null;
+    readonly names: LocalizedString;
+    readonly ordering: OrderingMethod | null;
+    readonly children: ReadonlyArray<Section>;
+    constructor(data?: SectionJson);
+    name(lang: string): string | null;
+    descendantById(id: string): Section | null;
+    toJSON(): SectionJson;
+    static fromJSON(data: SectionJson): Section;
+}
+//# sourceMappingURL=section.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../../src/models/section.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAIjD,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,aAAa,CAAC,WAAW,GAAG,OAAO,CAAC,CAAC;CACjD;AAED,qBAAa,OAAQ,SAAQ,eAAe;IAC1C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;gBAE9B,IAAI,GAAE,WAAgB;IAUlC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIjC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IASjC,MAAM,IAAI,WAAW;WAUd,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;CAGrD"}

package/dist/models/section.js

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

package/dist/models/section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.js","sourceRoot":"","sources":["../../src/models/section.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,MAAM,CAAC,MAAM,gBAAgB,GAA0B,MAAM,CAAC,MAAM,CAAC;IACnE,YAAY;IACZ,OAAO;IACP,cAAc;CACf,CAAC,CAAC;AAWH,MAAM,OAAO,OAAQ,SAAQ,eAAe;IACjC,EAAE,CAAgB;IAClB,KAAK,CAAkB;IACvB,QAAQ,CAAwB;IAChC,QAAQ,CAAyB;IAE1C,YAAY,OAAoB,EAAE;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAI,IAAI,CAAC,KAAyB,IAAI,EAAE,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C,CAAC,YAAY,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAgB,CAAC,CACzD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IACvD,CAAC;IAED,cAAc,CAAC,EAAU;QACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE;gBAAE,OAAO,KAAK,CAAC;YAClC,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YACvC,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEQ,MAAM;QACb,MAAM,GAAG,GAAgB,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACtE,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI;YAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,CAAU,QAAQ,CAAC,IAAiB;QACxC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACF"}

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

@@ -0,0 +1,32 @@
+import { AbstractHyperedge } from './abstract-hyperedge.js';
+import type { AbstractHyperedgeJson } from './abstract-hyperedge.js';
+import { SequentialMember } from './sequential-member.js';
+import type { SequentialMemberJson } from './sequential-member.js';
+export interface SequentialHyperedgeJson extends AbstractHyperedgeJson {
+    members: ReadonlyArray<SequentialMemberJson | SequentialMember>;
+}
+export declare class SequentialHyperedge extends AbstractHyperedge {
+    static wireKey: "sequential_relations";
+    static typeTag: "sequential_relation";
+    static rdfType: "gloss:SequentialRelation";
+    static memberClass: typeof SequentialMember;
+    static v1WireKeys: ReadonlyArray<string>;
+    static kindLabel: string;
+    readonly members: ReadonlyArray<SequentialMember>;
+    constructor(data?: Partial<SequentialHyperedgeJson>);
+    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: SequentialHyperedgeJson): SequentialHyperedge;
+}
+export default SequentialHyperedge;
+//# sourceMappingURL=sequential-hyperedge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequential-hyperedge.d.ts","sourceRoot":"","sources":["../../src/models/sequential-hyperedge.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,MAAM,WAAW,uBAAwB,SAAQ,qBAAqB;IACpE,OAAO,EAAE,aAAa,CAAC,oBAAoB,GAAG,gBAAgB,CAAC,CAAC;CACjE;AAED,qBAAa,mBAAoB,SAAQ,iBAAiB;IAExD,MAAM,CAAC,OAAO,EAAG,sBAAsB,CAAU;IACjD,MAAM,CAAC,OAAO,EAAG,qBAAqB,CAAU;IAChD,MAAM,CAAC,OAAO,EAAG,0BAA0B,CAAU;IACrD,MAAM,CAAC,WAAW,0BAAoB;IACtC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAM;IAC9C,MAAM,CAAC,SAAS,SAAS;IAEzB,SAAiB,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;gBAE9C,IAAI,GAAE,OAAO,CAAC,uBAAuB,CAAM;IAevD,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;WAWO,QAAQ,CAAC,IAAI,EAAE,uBAAuB,GAAG,mBAAmB;CAG7E;AAED,eAAe,mBAAmB,CAAC"}

package/dist/models/sequential-hyperedge.js

@@ -0,0 +1,49 @@
+// SequentialHyperedge — an ISO 12620 A.6.3 / ISO 704:2022 §5.5.5
+// sequential relation connecting a comprehensive concept to two or
+// more subordinate concepts in an ORDERED sequence (temporal,
+// spatial, causal, developmental).
+//
+// Mirror of PartitiveHyperedge and GenericHyperedge. Member array
+// order IS significant — reversing the array reverses the sequence.
+// Use cases: manufacturing process steps, biological life cycles,
+// software release lifecycles, supply chain stages, geological eras.
+import { AbstractHyperedge } from './abstract-hyperedge.js';
+import { SequentialMember } from './sequential-member.js';
+import { HyperedgeRegistry } from './hyperedge-registry.js';
+export class SequentialHyperedge extends AbstractHyperedge {
+    // Per-class metadata block — the OCP contract.
+    static wireKey = 'sequential_relations';
+    static typeTag = 'sequential_relation';
+    static rdfType = 'gloss:SequentialRelation';
+    static memberClass = SequentialMember;
+    static v1WireKeys = [];
+    static kindLabel = 'SEQ';
+    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 SequentialMember ? m : new SequentialMember(m));
+    }
+    static identityOf(value) {
+        const v = value ?? {};
+        const c = v.comprehensive ?? {};
+        // For sequential, member order IS significant — do NOT sort.
+        const memberKeys = (v.members ?? []).map((m) => {
+            const r = m?.ref ?? m ?? {};
+            return `${r.source ?? ''}:${r.id ?? ''}`;
+        });
+        return `${c.source ?? ''}:${c.id ?? ''}|${memberKeys.join('|')}`;
+    }
+    static fromJSON(data) {
+        return new SequentialHyperedge(data);
+    }
+}
+export default SequentialHyperedge;
+HyperedgeRegistry.register(SequentialHyperedge);
+//# sourceMappingURL=sequential-hyperedge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequential-hyperedge.js","sourceRoot":"","sources":["../../src/models/sequential-hyperedge.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,mEAAmE;AACnE,8DAA8D;AAC9D,mCAAmC;AACnC,EAAE;AACF,kEAAkE;AAClE,oEAAoE;AACpE,kEAAkE;AAClE,qEAAqE;AAErE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAM5D,MAAM,OAAO,mBAAoB,SAAQ,iBAAiB;IACxD,+CAA+C;IAC/C,MAAM,CAAC,OAAO,GAAG,sBAA+B,CAAC;IACjD,MAAM,CAAC,OAAO,GAAG,qBAA8B,CAAC;IAChD,MAAM,CAAC,OAAO,GAAG,0BAAmC,CAAC;IACrD,MAAM,CAAC,WAAW,GAAG,gBAAgB,CAAC;IACtC,MAAM,CAAC,UAAU,GAA0B,EAAE,CAAC;IAC9C,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;IAIzB,YAAY,OAAyC,EAAE;QACrD,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,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAyB,CAAC,CACpF,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,6DAA6D;QAC7D,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7C,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,CAAC;QACH,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,IAA6B;QACpD,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;;AAGH,eAAe,mBAAmB,CAAC;AAEnC,iBAAiB,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC"}

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

@@ -0,0 +1,8 @@
+import { HyperedgeMember } from './hyperedge-member.js';
+import type { HyperedgeMemberJson } from './hyperedge-member.js';
+export type SequentialMemberJson = HyperedgeMemberJson;
+export declare class SequentialMember extends HyperedgeMember {
+    static fromJSON(data: SequentialMemberJson): SequentialMember;
+}
+export default SequentialMember;
+//# sourceMappingURL=sequential-member.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequential-member.d.ts","sourceRoot":"","sources":["../../src/models/sequential-member.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAEvD,qBAAa,gBAAiB,SAAQ,eAAe;WACnC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB;CAGvE;AAED,eAAe,gBAAgB,CAAC"}

package/{src/models/sequential-member.ts → dist/models/sequential-member.js}

@@ -1,16 +1,11 @@
 // SequentialMember — one member of a SequentialHyperedge. Inherits
 // the MECE shape from HyperedgeMember. Distinct leaf class for type
 // safety. Member array order IS significant for sequential hyperedges.
-
 import { HyperedgeMember } from './hyperedge-member.js';
-import type { HyperedgeMemberJson } from './hyperedge-member.js';
-
-export type SequentialMemberJson = HyperedgeMemberJson;
-
 export class SequentialMember extends HyperedgeMember {
-  static override fromJSON(data: SequentialMemberJson): SequentialMember {
-    return new SequentialMember(data);
-  }
+    static fromJSON(data) {
+        return new SequentialMember(data);
+    }
 }
-
 export default SequentialMember;
+//# sourceMappingURL=sequential-member.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequential-member.js","sourceRoot":"","sources":["../../src/models/sequential-member.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,oEAAoE;AACpE,uEAAuE;AAEvE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAKxD,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACnD,MAAM,CAAU,QAAQ,CAAC,IAA0B;QACjD,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAED,eAAe,gBAAgB,CAAC"}

package/dist/models/shared-non-verbal-entity.d.ts

@@ -0,0 +1,16 @@
+import { NonVerbalEntity } from './non-verbal-entity.js';
+import type { NonVerbalEntityJson } from './non-verbal-entity.js';
+export interface SharedNonVerbalEntityJson extends NonVerbalEntityJson {
+    id?: string | null;
+    identifier?: string | null;
+}
+export declare class SharedNonVerbalEntity extends NonVerbalEntity {
+    readonly id: string | null;
+    readonly identifier: string | null;
+    constructor(data?: SharedNonVerbalEntityJson);
+    findById(targetId: string): this | null;
+    allIds(): string[];
+    toJSON(): SharedNonVerbalEntityJson;
+    static fromJSON(data: SharedNonVerbalEntityJson): SharedNonVerbalEntity;
+}
+//# sourceMappingURL=shared-non-verbal-entity.d.ts.map

package/dist/models/shared-non-verbal-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-non-verbal-entity.d.ts","sourceRoot":"","sources":["../../src/models/shared-non-verbal-entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,WAAW,yBAA0B,SAAQ,mBAAmB;IACpE,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,qBAAa,qBAAsB,SAAQ,eAAe;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEvB,IAAI,GAAE,yBAA8B;IAMvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAGvC,MAAM,IAAI,MAAM,EAAE;IAIlB,MAAM,IAAI,yBAAyB;WAO5B,QAAQ,CAAC,IAAI,EAAE,yBAAyB,GAAG,qBAAqB;CAGjF"}