@mailwoman/geographic-model 0.0.0

package/out/load.d.ts

@@ -0,0 +1,122 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The authoring loader: a directory of JSON files in, one {@link GeographicModelDocument} out.
+ *
+ *   **The filesystem layout is authoring convenience and carries no meaning.** A concept means the
+ *   same thing whichever file it was written in, and a file may hold any subset of the tables. What a
+ *   directory does carry is one manifest — `model.json`, holding the document's `version` — because a
+ *   version assembled from whichever fragment happened to declare one is a version nobody chose.
+ *
+ *   Two properties make the loader safe to build an artifact from:
+ *
+ *   1. **Enumeration order cannot reach the output.** {@link mergeGeographicModelFiles} sorts the
+ *      files it was handed before reading any of them, so the merged tables are a function of the file
+ *      NAMES and their contents. `readdir` order, and therefore the filesystem, is out of the answer.
+ *   2. **Every issue names the file it came from.** The document validator addresses a record by its
+ *      position in the merged table (`$.concepts[7].kind`), which is the one thing an author cannot
+ *      see; the loader keeps a per-record origin and re-addresses each issue to its source file. A
+ *      duplicate identifier names both files — the one that claimed it and the one that claimed it
+ *      first — because "already used" is unactionable without the other half.
+ *
+ *   Validation itself is delegated whole to `./validate.ts`. What the loader checks on its own is only
+ *   what the validator cannot see: whether a file parses, whether it is an object, and whether the
+ *   keys it uses are tables.
+ */
+import type { GeographicModelDocument } from "./schema.ts";
+/**
+ * The manifest every model directory carries: the document's `version`, and nothing else.
+ */
+export declare const MODEL_MANIFEST_FILENAME = "model.json";
+/**
+ * Every way loading can fail. The document validator's whole vocabulary, plus the one failure only a loader meets: a
+ * file that is not JSON at all.
+ */
+export declare const LoadIssueCode: {
+    /**
+     * A source file could not be parsed as JSON. Emitted by the loader alone; the document validator is handed values,
+     * never text.
+     */
+    readonly MalformedJSON: "malformed_json";
+    readonly MissingField: "missing_field";
+    readonly WrongType: "wrong_type";
+    readonly EmptyValue: "empty_value";
+    readonly EmptyList: "empty_list";
+    readonly UnknownField: "unknown_field";
+    readonly RankingField: "ranking_field";
+    readonly UnknownConceptKind: "unknown_concept_kind";
+    readonly UnknownModality: "unknown_modality";
+    readonly UnknownRelationSemantics: "unknown_relation_semantics";
+    readonly UnknownConceptStatus: "unknown_concept_status";
+    readonly UnknownExternalVocabulary: "unknown_external_vocabulary";
+    readonly UnknownDerivationInputKind: "unknown_derivation_input_kind";
+    readonly DuplicateID: "duplicate_id";
+    readonly SelfReference: "self_reference";
+    readonly CyclicIsA: "cyclic_isa";
+    readonly UnknownConcept: "unknown_concept";
+    readonly UnknownRelation: "unknown_relation";
+    readonly UnknownDerivationInput: "unknown_derivation_input";
+    readonly DomainKindMismatch: "domain_kind_mismatch";
+    readonly RangeKindMismatch: "range_kind_mismatch";
+    readonly InverseNotReciprocal: "inverse_not_reciprocal";
+    readonly InverseKindsMismatch: "inverse_kinds_mismatch";
+    readonly TransitiveKindsDisjoint: "transitive_kinds_disjoint";
+    readonly MalformedCountry: "malformed_country";
+};
+export type LoadIssueCode = (typeof LoadIssueCode)[keyof typeof LoadIssueCode];
+/**
+ * One violation, addressed to the file an author can open.
+ */
+export interface SourcedIssue {
+    /**
+     * The source file, relative to the model directory, with `/` separators on every platform.
+     */
+    file: string;
+    /**
+     * The JSONPath-style address into the MERGED document, kept so a reader can find the record in the table the
+     * validator saw.
+     */
+    path: string;
+    code: LoadIssueCode;
+    message: string;
+    /**
+     * For a duplicate identifier: the file that claimed it first.
+     */
+    otherFile?: string;
+}
+/**
+ * One authoring file: its path relative to the model directory, and its text.
+ */
+export interface GeographicModelSourceFile {
+    path: string;
+    text: string;
+}
+/**
+ * Render every issue as one line, `file:path: message [code]`, in the order the loader produced them.
+ */
+export declare function formatSourcedIssues(issues: readonly SourcedIssue[]): string;
+/**
+ * Thrown when a model directory does not load. Carries every issue, and states them all in its message, so a caller
+ * that only prints `error.message` still sees the whole list.
+ */
+export declare class GeographicModelLoadError extends Error {
+    readonly issues: readonly SourcedIssue[];
+    constructor(issues: readonly SourcedIssue[]);
+}
+/**
+ * Merge authoring files into one document, and validate the result.
+ *
+ * The files are sorted by path before anything is read, so any enumeration order produces the same tables in the same
+ * order. Throws {@link GeographicModelLoadError} with every issue, each addressed to its source file; returns nothing
+ * partial.
+ */
+export declare function mergeGeographicModelFiles(files: readonly GeographicModelSourceFile[]): GeographicModelDocument;
+/**
+ * Load a model directory: read every `*.json` file under it, merge them, and validate the result.
+ *
+ * Throws {@link GeographicModelLoadError} with every issue, each addressed to its source file.
+ */
+export declare function loadGeographicModelDirectory(root: string): GeographicModelDocument;
+//# sourceMappingURL=load.d.ts.map

package/out/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../load.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAY1D;;GAEG;AACH,eAAO,MAAM,uBAAuB,eAAe,CAAA;AAiBnD;;;GAGG;AACH,eAAO,MAAM,aAAa;IAEzB;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;CAEM,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAA;AAE9E;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,CAQ3E;AAED;;;GAGG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAClD,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;gBAE5B,MAAM,EAAE,SAAS,YAAY,EAAE;CAM3C;AA2KD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,yBAAyB,EAAE,GAAG,uBAAuB,CA4C9G;AA8BD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAIlF"}

package/out/load.js

@@ -0,0 +1,269 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The authoring loader: a directory of JSON files in, one {@link GeographicModelDocument} out.
+ *
+ *   **The filesystem layout is authoring convenience and carries no meaning.** A concept means the
+ *   same thing whichever file it was written in, and a file may hold any subset of the tables. What a
+ *   directory does carry is one manifest — `model.json`, holding the document's `version` — because a
+ *   version assembled from whichever fragment happened to declare one is a version nobody chose.
+ *
+ *   Two properties make the loader safe to build an artifact from:
+ *
+ *   1. **Enumeration order cannot reach the output.** {@link mergeGeographicModelFiles} sorts the
+ *      files it was handed before reading any of them, so the merged tables are a function of the file
+ *      NAMES and their contents. `readdir` order, and therefore the filesystem, is out of the answer.
+ *   2. **Every issue names the file it came from.** The document validator addresses a record by its
+ *      position in the merged table (`$.concepts[7].kind`), which is the one thing an author cannot
+ *      see; the loader keeps a per-record origin and re-addresses each issue to its source file. A
+ *      duplicate identifier names both files — the one that claimed it and the one that claimed it
+ *      first — because "already used" is unactionable without the other half.
+ *
+ *   Validation itself is delegated whole to `./validate.ts`. What the loader checks on its own is only
+ *   what the validator cannot see: whether a file parses, whether it is an object, and whether the
+ *   keys it uses are tables.
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { compareIdentifiers } from "./artifact.js";
+import { validateGeographicModelDocument } from "./validate.js";
+import { add, checkFieldNames, isPlainObject, readArray, readString, ValidationIssueCode, } from "./validation-issues.js";
+/**
+ * The manifest every model directory carries: the document's `version`, and nothing else.
+ */
+export const MODEL_MANIFEST_FILENAME = "model.json";
+/**
+ * The keys a source file may use. They are the document's tables, minus the manifest's `version`.
+ */
+const TABLE_FIELDS = ["relations", "concepts", "mappings", "observations", "derivedFacts"];
+const MANIFEST_FIELDS = ["version"];
+/**
+ * The document path a record occupies, e.g. `$.concepts[7]` or `$.concepts[7].assertions[1]`. Group 3 is present only
+ * for an assertion, which is the one record that nests.
+ */
+const RECORD_PATH_PATTERN = /^\$\.([A-Za-z]+)\[(\d+)\](?:\.assertions\[(\d+)\])?/u;
+/**
+ * Every way loading can fail. The document validator's whole vocabulary, plus the one failure only a loader meets: a
+ * file that is not JSON at all.
+ */
+export const LoadIssueCode = {
+    ...ValidationIssueCode,
+    /**
+     * A source file could not be parsed as JSON. Emitted by the loader alone; the document validator is handed values,
+     * never text.
+     */
+    MalformedJSON: "malformed_json",
+};
+/**
+ * Render every issue as one line, `file:path: message [code]`, in the order the loader produced them.
+ */
+export function formatSourcedIssues(issues) {
+    return issues
+        .map((issue) => {
+        const claimant = issue.otherFile ? ` — first claimed in ${issue.otherFile}` : "";
+        return `${issue.file}:${issue.path}: ${issue.message}${claimant} [${issue.code}]`;
+    })
+        .join("\n");
+}
+/**
+ * Thrown when a model directory does not load. Carries every issue, and states them all in its message, so a caller
+ * that only prints `error.message` still sees the whole list.
+ */
+export class GeographicModelLoadError extends Error {
+    issues;
+    constructor(issues) {
+        super(`geographic-model source does not load (${issues.length} issues)\n${formatSourcedIssues(issues)}`);
+        this.name = "GeographicModelLoadError";
+        this.issues = issues;
+    }
+}
+function sourced(file, issues) {
+    return issues.map((issue) => ({ file, path: issue.path, code: issue.code, message: issue.message }));
+}
+/**
+ * Parse one source file, or report why it could not be parsed.
+ *
+ * The house wrapper lives in `@mailwoman/core/objects`, and this package takes no dependency on `@mailwoman/core` — the
+ * boundary record keeps world semantics out of core, and a build-time loader is not the reason to reverse it. The
+ * parser's own message is also the useful half of the report here, which a wrapper returning a fallback discards.
+ */
+function readSourceJSON(file, issues) {
+    try {
+        // oxlint-disable-next-line no-restricted-properties -- see the note above.
+        return JSON.parse(file.text);
+    }
+    catch (error) {
+        issues.push({
+            file: file.path,
+            path: "$",
+            code: LoadIssueCode.MalformedJSON,
+            message: error instanceof Error ? error.message : String(error),
+        });
+        return undefined;
+    }
+}
+function claim(state, table, id, file) {
+    if (id === undefined)
+        return;
+    const claims = state.firstClaims.get(table) ?? new Map();
+    state.firstClaims.set(table, claims);
+    if (!claims.has(id)) {
+        claims.set(id, file);
+    }
+}
+function recordID(entry) {
+    if (!isPlainObject(entry))
+        return undefined;
+    return typeof entry.id === "string" ? entry.id : undefined;
+}
+function readManifestFile(state, file, value) {
+    const issues = [];
+    if (!isPlainObject(value)) {
+        add(issues, "$", ValidationIssueCode.WrongType, `\`${MODEL_MANIFEST_FILENAME}\` must be an object`);
+    }
+    else {
+        checkFieldNames(issues, "$", value, MANIFEST_FIELDS);
+        state.version = readString(issues, "$", value, "version", true);
+    }
+    state.issues.push(...sourced(file.path, issues));
+}
+/**
+ * Append one file's tables to the merged document, recording where every record came from.
+ */
+function readTableFile(state, file, value) {
+    const issues = [];
+    if (!isPlainObject(value)) {
+        add(issues, "$", ValidationIssueCode.WrongType, "a geographic-model source file must be an object");
+        state.issues.push(...sourced(file.path, issues));
+        return;
+    }
+    // `version` is admitted to the field check and then refused on its own, so the report names where a version belongs
+    // instead of only saying the field is unknown here.
+    checkFieldNames(issues, "$", value, [...TABLE_FIELDS, ...MANIFEST_FIELDS]);
+    if ("version" in value) {
+        add(issues, "$.version", ValidationIssueCode.UnknownField, `the document's \`version\` is authored in \`${MODEL_MANIFEST_FILENAME}\`, not in a table file`);
+    }
+    for (const table of TABLE_FIELDS) {
+        if (!(table in value))
+            continue;
+        for (const entry of readArray(issues, "$", value, table, false) ?? []) {
+            const index = state.tables[table].length;
+            const id = recordID(entry);
+            const documentPath = `${table}[${index}]`;
+            state.tables[table].push(entry);
+            state.origins.set(documentPath, { file: file.path, table, id });
+            claim(state, table, id, file.path);
+            if (table !== "concepts" || !isPlainObject(entry) || !Array.isArray(entry.assertions))
+                continue;
+            for (const [position, assertion] of entry.assertions.entries()) {
+                const assertionID = recordID(assertion);
+                state.origins.set(`${documentPath}.assertions[${position}]`, {
+                    file: file.path,
+                    table: "assertions",
+                    id: assertionID,
+                });
+                claim(state, "assertions", assertionID, file.path);
+            }
+        }
+    }
+    state.issues.push(...sourced(file.path, issues));
+}
+/**
+ * Re-address one validation issue from its position in the merged document to the file the record was authored in.
+ */
+function attribute(state, issue) {
+    const match = RECORD_PATH_PATTERN.exec(issue.path);
+    const nested = match?.[3];
+    const key = match ? `${match[1]}[${match[2]}]${nested ? `.assertions[${nested}]` : ""}` : undefined;
+    const origin = key ? state.origins.get(key) : undefined;
+    // A document-level issue — `$.version`, or the root itself — is about the manifest, which is the only file that
+    // contributes anything outside a table.
+    const file = origin?.file ?? MODEL_MANIFEST_FILENAME;
+    const claimant = issue.code === ValidationIssueCode.DuplicateID && origin?.id
+        ? state.firstClaims.get(origin.table)?.get(origin.id)
+        : undefined;
+    return {
+        file,
+        path: issue.path,
+        code: issue.code,
+        message: issue.message,
+        ...(claimant ? { otherFile: claimant } : {}),
+    };
+}
+/**
+ * Merge authoring files into one document, and validate the result.
+ *
+ * The files are sorted by path before anything is read, so any enumeration order produces the same tables in the same
+ * order. Throws {@link GeographicModelLoadError} with every issue, each addressed to its source file; returns nothing
+ * partial.
+ */
+export function mergeGeographicModelFiles(files) {
+    const state = {
+        issues: [],
+        tables: { relations: [], concepts: [], mappings: [], observations: [], derivedFacts: [] },
+        origins: new Map(),
+        firstClaims: new Map(),
+    };
+    const ordered = files.toSorted((left, right) => compareIdentifiers(left.path, right.path));
+    const manifest = ordered.find((file) => file.path === MODEL_MANIFEST_FILENAME);
+    if (!manifest) {
+        state.issues.push({
+            file: MODEL_MANIFEST_FILENAME,
+            path: "$",
+            code: LoadIssueCode.MissingField,
+            message: `a model directory carries \`${MODEL_MANIFEST_FILENAME}\`, holding the document's \`version\``,
+        });
+    }
+    for (const file of ordered) {
+        const value = readSourceJSON(file, state.issues);
+        if (value === undefined)
+            continue;
+        if (file === manifest) {
+            readManifestFile(state, file, value);
+            continue;
+        }
+        readTableFile(state, file, value);
+    }
+    // A record issue cannot be addressed to a file that failed to parse, so the structural pass reports alone.
+    if (state.issues.length)
+        throw new GeographicModelLoadError(state.issues);
+    const result = validateGeographicModelDocument({ version: state.version, ...state.tables });
+    if (!result.ok) {
+        throw new GeographicModelLoadError(result.issues.map((issue) => attribute(state, issue)));
+    }
+    return result.document;
+}
+/**
+ * Every `*.json` file under `root`, relative to it, in code-point order.
+ *
+ * Directory entries are sorted at each level rather than taken as `readdir` returns them, so the list is a property of
+ * the tree and not of the filesystem that stored it. Symbolic links are not followed: a model directory is source, and
+ * a link out of it is a record whose home nobody can state.
+ */
+function listSourceFiles(root, prefix = "") {
+    const entries = readdirSync(resolve(root, prefix), { withFileTypes: true });
+    const found = [];
+    for (const entry of entries.toSorted((left, right) => compareIdentifiers(left.name, right.name))) {
+        const path = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            found.push(...listSourceFiles(root, path));
+            continue;
+        }
+        if (entry.isFile() && entry.name.endsWith(".json")) {
+            found.push(path);
+        }
+    }
+    return found;
+}
+/**
+ * Load a model directory: read every `*.json` file under it, merge them, and validate the result.
+ *
+ * Throws {@link GeographicModelLoadError} with every issue, each addressed to its source file.
+ */
+export function loadGeographicModelDirectory(root) {
+    const files = listSourceFiles(root).map((path) => ({ path, text: readFileSync(resolve(root, path), "utf8") }));
+    return mergeGeographicModelFiles(files);
+}
+//# sourceMappingURL=load.js.map

package/out/load.js.map

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

package/out/lookup.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The read surface over a compiled artifact: every question answered by one map probe, none by
+ *   walking the graph.
+ *
+ *   The shape is deliberate. `@mailwoman/geographic-model` compiles authored records into an artifact
+ *   precisely so a runtime consumer never traverses anything — so the index exposes lookups
+ *   (`concept`, `ancestorsOf`, `derivedFactsAbout`, `conceptsForExternalID`) and no walk, no cursor,
+ *   and no query language.
+ *
+ *   Two absences are distinguished everywhere, because they are different answers. A lookup for a
+ *   concept the artifact does not carry returns `undefined` — the model cannot speak to it. A lookup
+ *   for a concept it does carry, which nothing was derived about, returns an empty list — the model
+ *   carries it and states nothing. A reader that collapsed the two would report "no ancestors" for a
+ *   concept it had never heard of.
+ */
+import type { POICategoryID } from "@mailwoman/poi-taxonomy/types";
+import { type CompiledGeographicModel } from "./artifact.ts";
+import type { ConceptID, ConceptRecord, DerivedFactRecord, ExternalVocabulary, RelationID, RelationRecord } from "./schema.ts";
+/**
+ * Lookups over one compiled artifact.
+ */
+export interface GeographicModelIndex {
+    /**
+     * The artifact these lookups read, so a consumer holding the index never has to carry both.
+     */
+    readonly model: CompiledGeographicModel;
+    /**
+     * One concept record, or `undefined` when the artifact does not carry it.
+     */
+    concept(id: ConceptID): ConceptRecord | undefined;
+    /**
+     * One relation definition, or `undefined` when the artifact does not carry it.
+     */
+    relation(id: RelationID): RelationRecord | undefined;
+    /**
+     * Every concept this one is a kind of, transitively, in code-point order. Empty for a concept that is a kind of
+     * nothing; `undefined` for a concept the artifact does not carry.
+     */
+    ancestorsOf(id: ConceptID): readonly ConceptID[] | undefined;
+    /**
+     * Every derived fact whose subject is this concept, in artifact order. Empty for a concept nothing was derived about;
+     * `undefined` for a concept the artifact does not carry.
+     */
+    derivedFactsAbout(id: ConceptID): readonly DerivedFactRecord[] | undefined;
+    /**
+     * The concepts a mapping translates this external identifier into, in code-point order.
+     *
+     * An empty list is a true negative rather than an unread answer: the artifact carries every mapping the document
+     * authored, so nothing having declared this identifier is the whole of what there is to know about it.
+     */
+    conceptsForExternalID(vocabulary: ExternalVocabulary, externalID: POICategoryID): readonly ConceptID[];
+}
+/**
+ * Index a compiled artifact for reading.
+ *
+ * Every table is walked once here so that no table is ever walked again. Nothing is copied — the records handed back
+ * are the artifact's own.
+ */
+export declare function createGeographicModelIndex(model: CompiledGeographicModel): GeographicModelIndex;
+//# sourceMappingURL=lookup.d.ts.map

package/out/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,EAAE,KAAK,uBAAuB,EAAsB,MAAM,eAAe,CAAA;AAChF,OAAO,KAAK,EACX,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAA;IACvC;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,CAAA;IACjD;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAAA;IACpD;;;OAGG;IACH,WAAW,CAAC,EAAE,EAAE,SAAS,GAAG,SAAS,SAAS,EAAE,GAAG,SAAS,CAAA;IAC5D;;;OAGG;IACH,iBAAiB,CAAC,EAAE,EAAE,SAAS,GAAG,SAAS,iBAAiB,EAAE,GAAG,SAAS,CAAA;IAC1E;;;;;OAKG;IACH,qBAAqB,CAAC,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,GAAG,SAAS,SAAS,EAAE,CAAA;CACtG;AAMD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,uBAAuB,GAAG,oBAAoB,CAmD/F"}

package/out/lookup.js

@@ -0,0 +1,68 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The read surface over a compiled artifact: every question answered by one map probe, none by
+ *   walking the graph.
+ *
+ *   The shape is deliberate. `@mailwoman/geographic-model` compiles authored records into an artifact
+ *   precisely so a runtime consumer never traverses anything — so the index exposes lookups
+ *   (`concept`, `ancestorsOf`, `derivedFactsAbout`, `conceptsForExternalID`) and no walk, no cursor,
+ *   and no query language.
+ *
+ *   Two absences are distinguished everywhere, because they are different answers. A lookup for a
+ *   concept the artifact does not carry returns `undefined` — the model cannot speak to it. A lookup
+ *   for a concept it does carry, which nothing was derived about, returns an empty list — the model
+ *   carries it and states nothing. A reader that collapsed the two would report "no ancestors" for a
+ *   concept it had never heard of.
+ */
+import { compareIdentifiers } from "./artifact.js";
+function externalKey(vocabulary, externalID) {
+    return `${vocabulary}\u0000${externalID}`;
+}
+/**
+ * Index a compiled artifact for reading.
+ *
+ * Every table is walked once here so that no table is ever walked again. Nothing is copied — the records handed back
+ * are the artifact's own.
+ */
+export function createGeographicModelIndex(model) {
+    const concepts = new Map(model.concepts.map((concept) => [String(concept.id), concept]));
+    const relations = new Map(model.relations.map((relation) => [String(relation.id), relation]));
+    const ancestors = new Map(model.inheritanceClosure.map((entry) => [String(entry.concept), entry.ancestors]));
+    const facts = new Map();
+    const external = new Map();
+    for (const fact of model.derivedFacts) {
+        const subject = String(fact.subject);
+        const existing = facts.get(subject);
+        if (existing) {
+            existing.push(fact);
+            continue;
+        }
+        facts.set(subject, [fact]);
+    }
+    for (const mapping of model.mappings) {
+        const key = externalKey(mapping.vocabulary, String(mapping.externalID));
+        const existing = external.get(key);
+        if (!existing) {
+            external.set(key, [mapping.concept]);
+            continue;
+        }
+        if (!existing.includes(mapping.concept)) {
+            existing.push(mapping.concept);
+        }
+    }
+    return {
+        model,
+        concept: (id) => concepts.get(String(id)),
+        relation: (id) => relations.get(String(id)),
+        ancestorsOf: (id) => ancestors.get(String(id)),
+        derivedFactsAbout: (id) => (concepts.has(String(id)) ? (facts.get(String(id)) ?? []) : undefined),
+        conceptsForExternalID: (vocabulary, externalID) => {
+            const matches = external.get(externalKey(vocabulary, String(externalID)));
+            return matches ? matches.toSorted(compareIdentifiers) : [];
+        },
+    };
+}
+//# sourceMappingURL=lookup.js.map

package/out/lookup.js.map

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