@concordance-wiki/inference 0.1.0

package/dist/frontmatter/resolve.d.ts

@@ -0,0 +1,32 @@
+import type { LinkableEntity } from "../explicit/types.js";
+/** Lookups built once over every entity: a reference is tried by identifier, by path, then by title. */
+export interface EntityIndex {
+    byId: ReadonlyMap<string, LinkableEntity>;
+    /** Keyed by `<source name>/<path>`. */
+    byPath: ReadonlyMap<string, LinkableEntity>;
+    /** Keyed by the trimmed title; several notes may share one. */
+    byTitle: ReadonlyMap<string, readonly LinkableEntity[]>;
+}
+export interface ResolveContext {
+    from: LinkableEntity;
+    index: EntityIndex;
+}
+export type ReferenceResolution = {
+    kind: "resolved";
+    entity: LinkableEntity;
+    by: "id" | "path" | "title";
+} | {
+    kind: "ambiguous";
+    candidates: readonly LinkableEntity[];
+} | {
+    kind: "unresolved";
+};
+export declare function indexEntities(entities: readonly LinkableEntity[]): EntityIndex;
+/**
+ * A reference is an identifier (`specs/roles/maintainer`, or `roles/maintainer` within the
+ * source of the note), a path relative to the source root (`roles/maintainer.md`), or the exact
+ * title of a note, compared after trimming and case-sensitively. Identifiers and paths are unique; a
+ * title shared by several notes resolves nothing.
+ */
+export declare function resolveReference(value: string, context: ResolveContext): ReferenceResolution;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/frontmatter/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/frontmatter/resolve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wGAAwG;AACxG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,uCAAuC;IACvC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,+DAA+D;IAC/D,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,EAAE,EAAE,IAAI,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAE3B,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,WAAW,CAe9E;AA8BD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,mBAAmB,CAO5F"}

package/dist/frontmatter/resolve.js

@@ -0,0 +1,62 @@
+import { identifierFor } from "@concordance-wiki/core";
+export function indexEntities(entities) {
+    const byId = new Map();
+    const byPath = new Map();
+    const byTitle = new Map();
+    for (const entity of entities) {
+        // The first entity of an identifier wins, as the duplicate resolution of the typing step decided.
+        if (!byId.has(entity.id))
+            byId.set(entity.id, entity);
+        const path = `${entity.source.name}/${entity.source.path}`;
+        if (!byPath.has(path))
+            byPath.set(path, entity);
+        const title = entity.title.trim();
+        const titled = byTitle.get(title) ?? [];
+        titled.push(entity);
+        byTitle.set(title, titled);
+    }
+    return { byId, byPath, byTitle };
+}
+function byIdentifier(value, context) {
+    return (context.index.byId.get(value) ?? context.index.byId.get(`${context.from.source.name}/${value}`));
+}
+/**
+ * A path carries its extension; it is tried as written, then through the identifier it derives, so
+ * that `Roles/Glossary Owner.md` names `roles/glossary-owner`.
+ */
+function byPath(value, context) {
+    if (!value.endsWith(".md"))
+        return undefined;
+    const source = context.from.source.name;
+    const exact = context.index.byPath.get(`${source}/${value}`);
+    if (exact !== undefined)
+        return exact;
+    const derived = identifierFor({ source, path: value, typeSuffixes: [] }).id;
+    return context.index.byId.get(derived);
+}
+function byTitle(value, context) {
+    const candidates = context.index.byTitle.get(value) ?? [];
+    const [single] = candidates;
+    if (single === undefined)
+        return { kind: "unresolved" };
+    return candidates.length === 1
+        ? { kind: "resolved", entity: single, by: "title" }
+        : { kind: "ambiguous", candidates };
+}
+/**
+ * A reference is an identifier (`specs/roles/maintainer`, or `roles/maintainer` within the
+ * source of the note), a path relative to the source root (`roles/maintainer.md`), or the exact
+ * title of a note, compared after trimming and case-sensitively. Identifiers and paths are unique; a
+ * title shared by several notes resolves nothing.
+ */
+export function resolveReference(value, context) {
+    const written = value.trim();
+    const identified = byIdentifier(written, context);
+    if (identified !== undefined)
+        return { kind: "resolved", entity: identified, by: "id" };
+    const located = byPath(written, context);
+    if (located !== undefined)
+        return { kind: "resolved", entity: located, by: "path" };
+    return byTitle(written, context);
+}
+//# sourceMappingURL=resolve.js.map

package/dist/frontmatter/resolve.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export { combineConfidences, glossaryConfidence } from "./combine/confidence.js";
+export type { GlossaryCombination } from "./combine/confidence.js";
+export { combineLinks, combineOptions } from "./combine/links.js";
+export type { CombineOptions } from "./combine/links.js";
+export { MAX_DISPLAYED_NEIGHBOURS, displayedNeighbourhood } from "./display/neighbourhood.js";
+export { displayOptions } from "./display/options.js";
+export { displayedNeighbourhoodToModel } from "./display/serialize.js";
+export type { DisplayableEntity, DisplayOptions, DisplayedNeighbour, DisplayedNeighbourhood, DisplayedNeighbourhoodInput, NeighbourDirection, NeighbourKind, } from "./display/types.js";
+export { duplicateOptions, DUPLICATE_DEFAULTS } from "./duplicates/options.js";
+export { DUPLICATE_CHECK, formatDuplicateStats, resolveDuplicateResources, } from "./duplicates/resolve.js";
+export type { DuplicateGroup, DuplicateInput, DuplicateLock, DuplicateMode, DuplicateOptions, DuplicatePair, DuplicateRepresentation, DuplicateResource, DuplicateResult, DuplicateSignal, DuplicateStats, } from "./duplicates/types.js";
+export { explicitLinks, locateLink } from "./explicit/links.js";
+export type { LocatedLink, SourceFiles } from "./explicit/links.js";
+export type { ExplicitLinksInput, ExplicitLinksResult, LinkableEntity, SourceResource, } from "./explicit/types.js";
+export { accumulateCooccurrences } from "./neighbourhood/accumulate.js";
+export { cooccurrenceLinks } from "./neighbourhood/links.js";
+export { neighbourhoodOptions } from "./neighbourhood/options.js";
+export { neighbourhoodToModel } from "./neighbourhood/serialize.js";
+export type { Neighbour, Neighbourhood, NeighbourhoodOptions, OccurrenceLike, } from "./neighbourhood/types.js";
+export { frontmatterLinks, type FrontmatterLinksInput, type FrontmatterLinksResult, } from "./frontmatter/links.js";
+export { indexEntities, resolveReference, type EntityIndex, type ReferenceResolution, type ResolveContext, } from "./frontmatter/resolve.js";
+export { mentionLinks, type MentionLinksInput, type MentionLinksResult, type MentionOccurrence, } from "./mentions/links.js";
+export { foldHeading, mappedSection, type MappedSection } from "./mentions/sections.js";
+export { FALLBACK_RELATION, RELATION_ORIGIN, relationLabel, typeRelations, type RelationLabelOptions, type TypedEntity, type TypeRelationsInput, type TypeRelationsResult, } from "./relations/index.js";
+export { attachOperations, CONTRACT_REPRESENTATION, importedOperations, MATCH_RUNGS, matchOperations, mergeOperation, OPERATION_AMBIGUOUS, OPERATION_UNMATCHED, operationNotes, redirectLinks, type Ambiguity, type AttachOperationsInput, type AttachOperationsResult, type ImportedOperation, type MatchResult, type MatchRung, type OperationMatch, type OperationNote, } from "./operations/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACjF,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,2BAA2B,EAC3B,kBAAkB,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,YAAY,EACV,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,aAAa,EACb,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+export { combineConfidences, glossaryConfidence } from "./combine/confidence.js";
+export { combineLinks, combineOptions } from "./combine/links.js";
+export { MAX_DISPLAYED_NEIGHBOURS, displayedNeighbourhood } from "./display/neighbourhood.js";
+export { displayOptions } from "./display/options.js";
+export { displayedNeighbourhoodToModel } from "./display/serialize.js";
+export { duplicateOptions, DUPLICATE_DEFAULTS } from "./duplicates/options.js";
+export { DUPLICATE_CHECK, formatDuplicateStats, resolveDuplicateResources, } from "./duplicates/resolve.js";
+export { explicitLinks, locateLink } from "./explicit/links.js";
+export { accumulateCooccurrences } from "./neighbourhood/accumulate.js";
+export { cooccurrenceLinks } from "./neighbourhood/links.js";
+export { neighbourhoodOptions } from "./neighbourhood/options.js";
+export { neighbourhoodToModel } from "./neighbourhood/serialize.js";
+export { frontmatterLinks, } from "./frontmatter/links.js";
+export { indexEntities, resolveReference, } from "./frontmatter/resolve.js";
+export { mentionLinks, } from "./mentions/links.js";
+export { foldHeading, mappedSection } from "./mentions/sections.js";
+export { FALLBACK_RELATION, RELATION_ORIGIN, relationLabel, typeRelations, } from "./relations/index.js";
+export { attachOperations, CONTRACT_REPRESENTATION, importedOperations, MATCH_RUNGS, matchOperations, mergeOperation, OPERATION_AMBIGUOUS, OPERATION_UNMATCHED, operationNotes, redirectLinks, } from "./operations/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAUvE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AAcjC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAOpE,OAAO,EACL,gBAAgB,GAGjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,aAAa,EACb,gBAAgB,GAIjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,YAAY,GAIb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAsB,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,aAAa,GAKd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,aAAa,GASd,MAAM,uBAAuB,CAAC"}

package/dist/mentions/links.d.ts

@@ -0,0 +1,43 @@
+import { type Link } from "@concordance-wiki/core";
+import { type Profile } from "@concordance-wiki/profile";
+import type { LinkableEntity } from "../explicit/types.js";
+/**
+ * What a mention needs to carry to become a link: the shape of an occurrence of the scan,
+ * re-declared structurally so that this package never depends on the scan itself.
+ */
+export interface MentionOccurrence {
+    target: {
+        id: string;
+    };
+    /** Name of the source holding the file the mention was read in. */
+    source: string;
+    /** Forward-slash path of that file relative to the source root. */
+    path: string;
+    line: number;
+    /** Heading of the enclosing H2 section, when any. */
+    section?: string;
+    /** The confidence the scan gave this mention (type prefix bonus, homonym factor); the base of the profile when absent. */
+    confidence?: number;
+    /** Code unit offset of the match in its paragraph. */
+    position?: number;
+    /** The match as written in the note. */
+    text?: string;
+    /** The text around the match as the scan cut it; the mentions panel of the target shows it. */
+    context?: string;
+}
+export interface MentionLinksInput {
+    occurrences: readonly MentionOccurrence[];
+    entities: readonly LinkableEntity[];
+    profile: Profile;
+}
+export interface MentionLinksResult {
+    links: Link[];
+}
+/**
+ * Every mention of an entity in the note of another gives a link from the note to the entity: the
+ * relation the profile maps to the enclosing section when there is one and the type pair admits
+ * it, `related` at the glossary occurrence confidence otherwise. Mentions of one target in one
+ * relation merge into one link with a provenance per mention.
+ */
+export declare function mentionLinks(input: MentionLinksInput): MentionLinksResult;
+//# sourceMappingURL=links.d.ts.map

package/dist/mentions/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/mentions/links.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,IAAI,EAEV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0HAA0H;IAC1H,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+FAA+F;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC1C,QAAQ,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAgCD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CA8FzE"}

package/dist/mentions/links.js

@@ -0,0 +1,106 @@
+import { compareLinks, compareProvenances, } from "@concordance-wiki/core";
+import { allowedRelations } from "@concordance-wiki/profile";
+import { mappedSection } from "./sections.js";
+function byCodeUnit(a, b) {
+    return Number(a > b) - Number(a < b);
+}
+function fileKey(source, path) {
+    return `${source}/${path}`;
+}
+/** The passage of a mention and the words matched, kept on its provenance when the scan reported them. */
+function passageOf(occurrence) {
+    if (occurrence.context === undefined)
+        return {};
+    return {
+        ...(occurrence.text === undefined ? {} : { text: occurrence.text }),
+        occurrences: [
+            {
+                line: occurrence.line,
+                ...(occurrence.position === undefined ? {} : { position: occurrence.position }),
+                context: occurrence.context,
+                ...(occurrence.section === undefined ? {} : { section: occurrence.section }),
+            },
+        ],
+    };
+}
+/**
+ * Every mention of an entity in the note of another gives a link from the note to the entity: the
+ * relation the profile maps to the enclosing section when there is one and the type pair admits
+ * it, `related` at the glossary occurrence confidence otherwise. Mentions of one target in one
+ * relation merge into one link with a provenance per mention.
+ */
+export function mentionLinks(input) {
+    const { profile } = input;
+    const sectionConfidence = profile.confidence.section_mention ?? 0.7;
+    const occurrenceConfidence = profile.confidence.glossary_occurrence?.base ?? 0.6;
+    const byFile = new Map(input.entities.map((entity) => [fileKey(entity.source.name, entity.source.path), entity]));
+    const byId = new Map(input.entities.map((entity) => [entity.id, entity]));
+    const merged = new Map();
+    const record = (source, target, relation, attributes, provenance) => {
+        // An undirected relation goes from the smaller identifier, so that reciprocal mentions merge.
+        const undirected = profile.relations[relation]?.directed === false;
+        const [from, to] = undirected && target.id < source.id ? [target, source] : [source, target];
+        const serialised = JSON.stringify(attributes);
+        const key = `${from.id} ${to.id} ${relation} ${serialised}`;
+        const existing = merged.get(key);
+        if (existing === undefined) {
+            merged.set(key, {
+                link: {
+                    from: from.id,
+                    to: to.id,
+                    relation,
+                    attributes,
+                    confidence: provenance.confidence,
+                    provenance: [provenance],
+                },
+                attributes: serialised,
+            });
+        }
+        else {
+            // Every mention keeps its provenance; combining their confidences is a later step.
+            existing.link.provenance.push(provenance);
+        }
+    };
+    for (const occurrence of input.occurrences) {
+        const from = byFile.get(fileKey(occurrence.source, occurrence.path));
+        const to = byId.get(occurrence.target.id);
+        if (from === undefined || to === undefined || to.id === from.id)
+            continue;
+        const type = profile.types[from.type];
+        const section = type === undefined || occurrence.section === undefined
+            ? undefined
+            : mappedSection(occurrence.section, type);
+        if (section !== undefined) {
+            const { produces, inverse, attributes } = section.definition;
+            const [source, target] = inverse === true ? [to, from] : [from, to];
+            // A mention is a recognised word, not a declared reference: when the section's relation
+            // does not join these two types, the mention counts as any other one instead of erring.
+            if (allowedRelations(profile, source.type, target.type).includes(produces)) {
+                record(source, target, produces, { ...attributes }, {
+                    method: "section_mention",
+                    confidence: sectionConfidence,
+                    path: occurrence.path,
+                    line: occurrence.line,
+                    section: section.name,
+                    ...passageOf(occurrence),
+                });
+                continue;
+            }
+        }
+        // The relation typing step refines `related` later, once every method has spoken.
+        record(from, to, "related", {}, {
+            method: "glossary_occurrence",
+            confidence: occurrence.confidence ?? occurrenceConfidence,
+            path: occurrence.path,
+            line: occurrence.line,
+            ...passageOf(occurrence),
+        });
+    }
+    const links = [...merged.values()]
+        .sort((a, b) => compareLinks(a.link, b.link) || byCodeUnit(a.attributes, b.attributes))
+        .map((candidate) => candidate.link);
+    for (const link of links)
+        link.provenance.sort(compareProvenances);
+    return { links };
+}
+//# sourceMappingURL=links.js.map

package/dist/mentions/links.js.map

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

package/dist/mentions/sections.d.ts

@@ -0,0 +1,17 @@
+import type { SectionDefinition, TypeDefinition } from "@concordance-wiki/profile";
+export interface MappedSection {
+    /** The key of the section in the profile, `objects` for `## Objects`. */
+    name: string;
+    definition: SectionDefinition;
+}
+/**
+ * The comparison form of a heading: accents folded, lower-cased, surrounding and repeated
+ * whitespace removed, so that `## OBJECTS`, `## objets` and `##  Objets ` all read the same.
+ */
+export declare function foldHeading(heading: string): string;
+/**
+ * The section of `type` whose key or heading label, in any locale of the profile, reads as
+ * `heading`; sections are tried in the key order of the profile.
+ */
+export declare function mappedSection(heading: string, type: TypeDefinition): MappedSection | undefined;
+//# sourceMappingURL=sections.d.ts.map

package/dist/mentions/sections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../src/mentions/sections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAQD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,aAAa,GAAG,SAAS,CAQ9F"}

package/dist/mentions/sections.js

@@ -0,0 +1,26 @@
+/**
+ * The comparison form of a heading: accents folded, lower-cased, surrounding and repeated
+ * whitespace removed, so that `## OBJECTS`, `## objets` and `##  Objets ` all read the same.
+ */
+export function foldHeading(heading) {
+    return heading.normalize("NFD").replace(/\p{M}/gu, "").toLowerCase().trim().replace(/\s+/g, " ");
+}
+function labelsOf(name, definition) {
+    // The key itself is accepted as a heading, so that an author may write the profile's own vocabulary.
+    // The spread gives the label an anonymous type, which `Object.values` can read locale by locale.
+    return [name, ...Object.values({ ...definition.heading })];
+}
+/**
+ * The section of `type` whose key or heading label, in any locale of the profile, reads as
+ * `heading`; sections are tried in the key order of the profile.
+ */
+export function mappedSection(heading, type) {
+    const folded = foldHeading(heading);
+    for (const [name, definition] of Object.entries(type.sections ?? {})) {
+        if (labelsOf(name, definition).some((label) => foldHeading(label) === folded)) {
+            return { name, definition };
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=sections.js.map

package/dist/mentions/sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.js","sourceRoot":"","sources":["../../src/mentions/sections.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACnG,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,UAA6B;IAC3D,qGAAqG;IACrG,iGAAiG;IACjG,OAAO,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,CAAS,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,IAAoB;IACjE,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,CAAC;QACrE,IAAI,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,EAAE,CAAC;YAC9E,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/neighbourhood/accumulate.d.ts

@@ -0,0 +1,11 @@
+import type { Neighbourhood, NeighbourhoodOptions, OccurrenceLike } from "./types.js";
+/**
+ * Two entities named in the same paragraph are neighbours; their count is the number of such
+ * paragraphs. Each node keeps its own row of counts, trimmed to the best `k` whenever it grows
+ * past `2k`, so that memory stays proportional to the number of nodes times `k` and never to the
+ * square of the number of nodes. A neighbour dropped by a trim starts again from zero if it
+ * reappears: the counts of the retained neighbours are exact only when the neighbour was never
+ * dropped, which holds as soon as the frequent pairs stand out from the occasional ones.
+ */
+export declare function accumulateCooccurrences(occurrences: readonly OccurrenceLike[], options: NeighbourhoodOptions): Neighbourhood;
+//# sourceMappingURL=accumulate.d.ts.map

package/dist/neighbourhood/accumulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accumulate.d.ts","sourceRoot":"","sources":["../../src/neighbourhood/accumulate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,aAAa,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgDjG;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,SAAS,cAAc,EAAE,EACtC,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CA6Bf"}

package/dist/neighbourhood/accumulate.js

@@ -0,0 +1,73 @@
+import { byCodeUnit, compareNeighbours } from "./order.js";
+/**
+ * Distinct identifiers paired in one paragraph. A paragraph naming more entities is a list or a
+ * table rather than prose; pairing all of them would cost a quadratic number of increments for
+ * a signal that says little, so only the first ones by identifier are paired.
+ */
+const PARAGRAPH_CAP = 200;
+function best(row, k) {
+    return [...row]
+        .map(([id, count]) => ({ id, count }))
+        .sort(compareNeighbours)
+        .slice(0, k);
+}
+function compareParagraphs(a, b) {
+    return byCodeUnit(a.source, b.source) || byCodeUnit(a.path, b.path) || a.line - b.line;
+}
+/**
+ * The distinct identifiers of every paragraph, paragraphs in `(source, path, line)` order and
+ * identifiers in code-unit order, so that the result depends on the set of occurrences alone.
+ */
+function paragraphs(occurrences) {
+    const byKey = new Map();
+    for (const occurrence of occurrences) {
+        const source = occurrence.source ?? "";
+        const key = `${source}\n${occurrence.path}\n${String(occurrence.line)}`;
+        let paragraph = byKey.get(key);
+        if (paragraph === undefined) {
+            paragraph = { source, path: occurrence.path, line: occurrence.line, members: new Set() };
+            byKey.set(key, paragraph);
+        }
+        paragraph.members.add(occurrence.target.id);
+    }
+    return [...byKey.values()]
+        .sort(compareParagraphs)
+        .map((paragraph) => [...paragraph.members].sort(byCodeUnit).slice(0, PARAGRAPH_CAP));
+}
+/**
+ * Two entities named in the same paragraph are neighbours; their count is the number of such
+ * paragraphs. Each node keeps its own row of counts, trimmed to the best `k` whenever it grows
+ * past `2k`, so that memory stays proportional to the number of nodes times `k` and never to the
+ * square of the number of nodes. A neighbour dropped by a trim starts again from zero if it
+ * reappears: the counts of the retained neighbours are exact only when the neighbour was never
+ * dropped, which holds as soon as the frequent pairs stand out from the occasional ones.
+ */
+export function accumulateCooccurrences(occurrences, options) {
+    const { k } = options;
+    const rows = new Map();
+    const bump = (from, to) => {
+        let row = rows.get(from);
+        if (row === undefined) {
+            row = new Map();
+            rows.set(from, row);
+        }
+        row.set(to, (row.get(to) ?? 0) + 1);
+        if (row.size > 2 * k) {
+            rows.set(from, new Map(best(row, k).map((neighbour) => [neighbour.id, neighbour.count])));
+        }
+    };
+    for (const members of paragraphs(occurrences)) {
+        // Members are distinct: every unordered pair is met once and a node never meets itself.
+        for (const a of members) {
+            for (const b of members) {
+                if (a < b) {
+                    bump(a, b);
+                    bump(b, a);
+                }
+            }
+        }
+    }
+    const nodes = new Map([...rows].sort(([a], [b]) => byCodeUnit(a, b)).map(([id, row]) => [id, best(row, k)]));
+    return { k, nodes };
+}
+//# sourceMappingURL=accumulate.js.map

package/dist/neighbourhood/accumulate.js.map

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

package/dist/neighbourhood/links.d.ts

@@ -0,0 +1,13 @@
+import { type Link } from "@concordance-wiki/core";
+import type { Profile } from "@concordance-wiki/profile";
+import type { Neighbourhood } from "./types.js";
+/**
+ * One undirected `related` link per neighbour pair at the `cooccurrence` confidence of the
+ * profile, the number of shared paragraphs as its provenance. A pair is listed by either of its
+ * nodes or by both; when the two rows disagree, a trim reset one of them and the larger count is
+ * the closer to the truth. The relation typing step may refine `related` from the type pair.
+ */
+export declare function cooccurrenceLinks(neighbourhood: Neighbourhood, options: {
+    profile: Profile;
+}): Link[];
+//# sourceMappingURL=links.d.ts.map

package/dist/neighbourhood/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/neighbourhood/links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,IAAI,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAQhD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,GAC5B,IAAI,EAAE,CAyBR"}

package/dist/neighbourhood/links.js

@@ -0,0 +1,35 @@
+import { compareLinks } from "@concordance-wiki/core";
+/**
+ * One undirected `related` link per neighbour pair at the `cooccurrence` confidence of the
+ * profile, the number of shared paragraphs as its provenance. A pair is listed by either of its
+ * nodes or by both; when the two rows disagree, a trim reset one of them and the larger count is
+ * the closer to the truth. The relation typing step may refine `related` from the type pair.
+ */
+export function cooccurrenceLinks(neighbourhood, options) {
+    const confidence = options.profile.confidence.cooccurrence ?? 0.4;
+    const pairs = new Map();
+    for (const [id, neighbours] of neighbourhood.nodes) {
+        for (const neighbour of neighbours) {
+            const [from, to] = id < neighbour.id ? [id, neighbour.id] : [neighbour.id, id];
+            const key = `${from} ${to}`;
+            const existing = pairs.get(key);
+            if (existing === undefined) {
+                pairs.set(key, { from, to, count: neighbour.count });
+            }
+            else {
+                existing.count = Math.max(existing.count, neighbour.count);
+            }
+        }
+    }
+    return [...pairs.values()]
+        .map(({ from, to, count }) => ({
+        from,
+        to,
+        relation: "related",
+        attributes: {},
+        confidence,
+        provenance: [{ method: "cooccurrence", confidence, count }],
+    }))
+        .sort(compareLinks);
+}
+//# sourceMappingURL=links.js.map

package/dist/neighbourhood/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/neighbourhood/links.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,MAAM,wBAAwB,CAAC;AAWjE;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,aAA4B,EAC5B,OAA6B;IAE7B,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,IAAI,GAAG,CAAC;IAClE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;IACtC,KAAK,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;QACnD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/E,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;SACvB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAQ,EAAE,CAAC,CAAC;QACnC,IAAI;QACJ,EAAE;QACF,QAAQ,EAAE,SAAS;QACnB,UAAU,EAAE,EAAE;QACd,UAAU;QACV,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;KAC5D,CAAC,CAAC;SACF,IAAI,CAAC,YAAY,CAAC,CAAC;AACxB,CAAC"}

package/dist/neighbourhood/options.d.ts

@@ -0,0 +1,5 @@
+import type { InferenceConfig } from "@concordance-wiki/core";
+import type { NeighbourhoodOptions } from "./types.js";
+/** `inference.neighbours.k` of the configuration, 50 when unset. */
+export declare function neighbourhoodOptions(inference?: InferenceConfig): NeighbourhoodOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/neighbourhood/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/neighbourhood/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,eAAe,GAAG,oBAAoB,CAEtF"}

package/dist/neighbourhood/options.js

@@ -0,0 +1,6 @@
+const DEFAULT_K = 50;
+/** `inference.neighbours.k` of the configuration, 50 when unset. */
+export function neighbourhoodOptions(inference) {
+    return { k: inference?.neighbours?.k ?? DEFAULT_K };
+}
+//# sourceMappingURL=options.js.map

package/dist/neighbourhood/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/neighbourhood/options.ts"],"names":[],"mappings":"AAIA,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,oEAAoE;AACpE,MAAM,UAAU,oBAAoB,CAAC,SAA2B;IAC9D,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;AACtD,CAAC"}

package/dist/neighbourhood/order.d.ts

@@ -0,0 +1,5 @@
+import type { Neighbour } from "./types.js";
+export declare function byCodeUnit(a: string, b: string): number;
+/** Best first: the larger count, then the lower identifier. */
+export declare function compareNeighbours(a: Neighbour, b: Neighbour): number;
+//# sourceMappingURL=order.d.ts.map

package/dist/neighbourhood/order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.d.ts","sourceRoot":"","sources":["../../src/neighbourhood/order.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAEpE"}

package/dist/neighbourhood/order.js

@@ -0,0 +1,9 @@
+// Code-unit order, not locale order: the output must not depend on the collation data of the runtime.
+export function byCodeUnit(a, b) {
+    return Number(a > b) - Number(a < b);
+}
+/** Best first: the larger count, then the lower identifier. */
+export function compareNeighbours(a, b) {
+    return b.count - a.count || byCodeUnit(a.id, b.id);
+}
+//# sourceMappingURL=order.js.map

package/dist/neighbourhood/order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order.js","sourceRoot":"","sources":["../../src/neighbourhood/order.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS;IAC7C,OAAO,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,CAAY,EAAE,CAAY;IAC1D,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/neighbourhood/serialize.d.ts

@@ -0,0 +1,4 @@
+import type { Neighbour, Neighbourhood } from "./types.js";
+/** The `neighbours` block of `model.json`: keys in identifier order, each list best first. */
+export declare function neighbourhoodToModel(neighbourhood: Neighbourhood): Record<string, Neighbour[]>;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/neighbourhood/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../src/neighbourhood/serialize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAM9F"}

package/dist/neighbourhood/serialize.js

@@ -0,0 +1,10 @@
+import { byCodeUnit } from "./order.js";
+/** The `neighbours` block of `model.json`: keys in identifier order, each list best first. */
+export function neighbourhoodToModel(neighbourhood) {
+    const block = {};
+    for (const [id, neighbours] of [...neighbourhood.nodes].sort(([a], [b]) => byCodeUnit(a, b))) {
+        block[id] = neighbours.map((neighbour) => ({ ...neighbour }));
+    }
+    return block;
+}
+//# sourceMappingURL=serialize.js.map

package/dist/neighbourhood/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../../src/neighbourhood/serialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,8FAA8F;AAC9F,MAAM,UAAU,oBAAoB,CAAC,aAA4B;IAC/D,MAAM,KAAK,GAAgC,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,KAAK,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}