@ifc-lite/data 1.14.5 → 1.15.0

package/README.md

@@ -36,6 +36,20 @@ const graph: RelationshipGraph = graphBuilder.build();
 - Relationship graph with typed edges
 - IFC type enum for fast type comparisons
 - Spatial hierarchy representation
+- Local EPSG CRS index with exact-code lookup and text search
+
+## EPSG Lookup
+
+```typescript
+import { lookupEpsgByCode, searchEpsgIndex } from '@ifc-lite/data';
+
+const lv95 = await lookupEpsgByCode(2056);
+const search = await searchEpsgIndex('web mercator');
+```
+
+The EPSG search index is generated ahead of time and committed to the repo, so
+normal builds stay offline and fast. Refresh it explicitly with
+`pnpm generate:epsg-index`.
 
 ## API
 

package/dist/epsg-index.d.ts

@@ -0,0 +1,10 @@
+import type { EpsgIndexEntry, LookupEpsgByCodeOptions, SearchEpsgIndexOptions } from './epsg-types.js';
+export declare function loadEpsgIndex(): Promise<readonly EpsgIndexEntry[]>;
+export declare function loadEpsgIndexDatasetVersion(): Promise<string>;
+export declare function loadEpsgIndexByCode(): Promise<ReadonlyMap<string, EpsgIndexEntry>>;
+export declare function lookupEpsgByCode(code: string | number): Promise<EpsgIndexEntry | undefined>;
+export declare function lookupEpsgByCode(code: string | number, options: LookupEpsgByCodeOptions & {
+    prefix: true;
+}): Promise<EpsgIndexEntry[]>;
+export declare function searchEpsgIndex(query: string, options?: SearchEpsgIndexOptions): Promise<EpsgIndexEntry[]>;
+//# sourceMappingURL=epsg-index.d.ts.map

package/dist/epsg-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epsg-index.d.ts","sourceRoot":"","sources":["../src/epsg-index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AA8CzB,wBAAsB,aAAa,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAUxE;AAED,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC,CAUnE;AAED,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAUxF;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;AACnG,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,OAAO,EAAE,uBAAuB,GAAG;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAClD,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;AAuB7B,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,cAAc,EAAE,CAAC,CAe3B"}

package/dist/epsg-index.js

@@ -0,0 +1,111 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+let epsgIndexPromise = null;
+let epsgByCodePromise = null;
+let epsgDatasetVersionPromise = null;
+function normalizeQuery(query) {
+    return query.trim().toLowerCase();
+}
+function normalizeLimit(limit, fallback = 25) {
+    const numericLimit = typeof limit === 'number' ? limit : Number(limit);
+    if (!Number.isFinite(numericLimit))
+        return fallback;
+    return Math.max(1, Math.floor(numericLimit));
+}
+function scoreEntry(entry, query) {
+    if (!query)
+        return 0;
+    let score = 0;
+    if (entry.code === query)
+        score += 1000;
+    else if (entry.code.startsWith(query))
+        score += 700;
+    const name = entry.name.toLowerCase();
+    const tokens = query.split(/\s+/).filter(Boolean);
+    const tokenMatches = tokens.filter(token => entry.searchText.includes(token)).length;
+    if (name === query)
+        score += 500;
+    else if (name.startsWith(query))
+        score += 350;
+    else if (name.includes(query))
+        score += 200;
+    for (const alias of entry.aliases) {
+        const aliasLower = alias.toLowerCase();
+        if (aliasLower === query)
+            score += 250;
+        else if (aliasLower.startsWith(query))
+            score += 175;
+        else if (aliasLower.includes(query))
+            score += 100;
+    }
+    if (entry.searchText.includes(query))
+        score += 50;
+    if (tokens.length > 1 && tokenMatches === tokens.length)
+        score += 120;
+    else
+        score += tokenMatches * 20;
+    if (!entry.deprecated)
+        score += 10;
+    return score;
+}
+export async function loadEpsgIndex() {
+    if (!epsgIndexPromise) {
+        epsgIndexPromise = import('./generated/epsg-index.generated.js').then(module => module.EPSG_INDEX).catch(error => {
+            epsgIndexPromise = null;
+            throw error;
+        });
+    }
+    return epsgIndexPromise;
+}
+export async function loadEpsgIndexDatasetVersion() {
+    if (!epsgDatasetVersionPromise) {
+        epsgDatasetVersionPromise = import('./generated/epsg-index.generated.js').then(module => module.EPSG_INDEX_DATASET_VERSION).catch(error => {
+            epsgDatasetVersionPromise = null;
+            throw error;
+        });
+    }
+    return epsgDatasetVersionPromise;
+}
+export async function loadEpsgIndexByCode() {
+    if (!epsgByCodePromise) {
+        epsgByCodePromise = loadEpsgIndex().then(entries => new Map(entries.map(entry => [entry.code, entry]))).catch(error => {
+            epsgByCodePromise = null;
+            throw error;
+        });
+    }
+    return epsgByCodePromise;
+}
+export async function lookupEpsgByCode(code, options = {}) {
+    const key = String(code).trim();
+    if (!key)
+        return undefined;
+    if (options.prefix) {
+        const limit = normalizeLimit(options.limit, 25);
+        const includeDeprecated = options.includeDeprecated ?? false;
+        const entries = await loadEpsgIndex();
+        return entries
+            .filter(entry => entry.code.startsWith(key))
+            .filter(entry => includeDeprecated || !entry.deprecated)
+            .sort((left, right) => Number(left.code) - Number(right.code))
+            .slice(0, limit);
+    }
+    const byCode = await loadEpsgIndexByCode();
+    return byCode.get(key);
+}
+export async function searchEpsgIndex(query, options = {}) {
+    const normalized = normalizeQuery(query);
+    if (!normalized)
+        return [];
+    const limit = normalizeLimit(options.limit, 25);
+    const includeDeprecated = options.includeDeprecated ?? false;
+    const entries = await loadEpsgIndex();
+    return entries
+        .filter(entry => includeDeprecated || !entry.deprecated)
+        .map(entry => ({ entry, score: scoreEntry(entry, normalized) }))
+        .filter(result => result.score > 0)
+        .sort((left, right) => right.score - left.score || Number(left.entry.code) - Number(right.entry.code))
+        .slice(0, limit)
+        .map(result => result.entry);
+}
+//# sourceMappingURL=epsg-index.js.map

package/dist/epsg-index.js.map

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

package/dist/epsg-types.d.ts

@@ -0,0 +1,24 @@
+export type EpsgKind = 'Projected' | 'Geographic' | 'Compound' | 'Vertical' | 'Engineering' | 'Geocentric' | 'Derived' | 'Unknown';
+export interface EpsgIndexEntry {
+    code: string;
+    name: string;
+    kind: EpsgKind | string;
+    area: string;
+    scope: string;
+    datum: string;
+    projection: string;
+    unit: string;
+    deprecated: boolean;
+    aliases: string[];
+    searchText: string;
+}
+export interface SearchEpsgIndexOptions {
+    includeDeprecated?: boolean;
+    limit?: number;
+}
+export interface LookupEpsgByCodeOptions {
+    prefix?: boolean;
+    includeDeprecated?: boolean;
+    limit?: number;
+}
+//# sourceMappingURL=epsg-types.d.ts.map

package/dist/epsg-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epsg-types.d.ts","sourceRoot":"","sources":["../src/epsg-types.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,YAAY,GACZ,UAAU,GACV,UAAU,GACV,aAAa,GACb,YAAY,GACZ,SAAS,GACT,SAAS,CAAC;AAEd,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/epsg-types.js

@@ -0,0 +1,5 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export {};
+//# sourceMappingURL=epsg-types.js.map

package/dist/epsg-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epsg-types.js","sourceRoot":"","sources":["../src/epsg-types.ts"],"names":[],"mappings":"AAAA;;+DAE+D"}

package/dist/generated/epsg-index.generated.d.ts

@@ -0,0 +1,13 @@
+/**
+ * AUTO-GENERATED by `scripts/generate-epsg-index.ts`.
+ *
+ * Source: EPSG Registry API (https://apps.epsg.org/api/v1)
+ * Dataset version: 12.054
+ * Terms: https://epsg.org/terms-of-use.html
+ *
+ * Do not edit by hand. Re-run `pnpm generate:epsg-index` to refresh.
+ */
+import type { EpsgIndexEntry } from '../epsg-types.js';
+export declare const EPSG_INDEX_DATASET_VERSION = "12.054";
+export declare const EPSG_INDEX: readonly EpsgIndexEntry[];
+//# sourceMappingURL=epsg-index.generated.d.ts.map

package/dist/generated/epsg-index.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epsg-index.generated.d.ts","sourceRoot":"","sources":["../../src/generated/epsg-index.generated.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,eAAO,MAAM,0BAA0B,WAAW,CAAC;AAInD,eAAO,MAAM,UAAU,EAAE,SAAS,cAAc,EAAoD,CAAC"}