@polintpro/proposit-core 0.7.3 → 0.8.0

package/dist/lib/utils/lookup.d.ts

@@ -0,0 +1,47 @@
+import type { TClaimLookup, TSourceLookup, TClaimSourceLookup } from "../core/interfaces/library.interfaces.js";
+/**
+ * Creates a keyed lookup from an array of items. Items are indexed by a
+ * composite string key (typically `"id:version"`), and the returned object
+ * exposes a `get(id, version)` method that reconstructs the same key
+ * internally.
+ *
+ * Use this to build the `TClaimLookup` or `TSourceLookup` required by
+ * `ArgumentEngine`'s constructor from flat arrays (e.g. database query
+ * results).
+ *
+ * @param items - The array of items to index.
+ * @param getKey - A function that produces the composite key for each item.
+ *   Must return a string of the form `"id:version"` so that the returned
+ *   `get(id, version)` method can reconstruct it.
+ * @returns An object with a `get(id, version)` method that looks up items
+ *   by reconstructing the composite key. Returns `undefined` if no item
+ *   matches.
+ *
+ * @example
+ * ```ts
+ * const claimLookup = createLookup(claims, (c) => `${c.id}:${c.version}`)
+ * const sourceLookup = createLookup(sources, (s) => `${s.id}:${s.version}`)
+ * const engine = new ArgumentEngine(arg, claimLookup, sourceLookup, ...)
+ * ```
+ */
+export declare function createLookup<T>(items: T[], getKey: (item: T) => string): {
+    get(id: string, version: number): T | undefined;
+};
+/**
+ * A no-op claim lookup that always returns `undefined`. Use this when the
+ * consumer does not use claims (e.g. an argument with no claim-bound
+ * variables).
+ */
+export declare const EMPTY_CLAIM_LOOKUP: TClaimLookup;
+/**
+ * A no-op source lookup that always returns `undefined`. Use this when the
+ * consumer does not use sources.
+ */
+export declare const EMPTY_SOURCE_LOOKUP: TSourceLookup;
+/**
+ * A no-op claim-source association lookup that always returns `undefined`
+ * or empty arrays. Use this when the consumer does not use claim-source
+ * associations.
+ */
+export declare const EMPTY_CLAIM_SOURCE_LOOKUP: TClaimSourceLookup;
+//# sourceMappingURL=lookup.d.ts.map

package/dist/lib/utils/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,YAAY,EACZ,aAAa,EACb,kBAAkB,EACrB,MAAM,0CAA0C,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,EAAE,EACV,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAC5B;IAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAA;CAAE,CAUrD;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAEhC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAEjC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAIvC,CAAA"}

package/dist/lib/utils/lookup.js

@@ -0,0 +1,62 @@
+/**
+ * Creates a keyed lookup from an array of items. Items are indexed by a
+ * composite string key (typically `"id:version"`), and the returned object
+ * exposes a `get(id, version)` method that reconstructs the same key
+ * internally.
+ *
+ * Use this to build the `TClaimLookup` or `TSourceLookup` required by
+ * `ArgumentEngine`'s constructor from flat arrays (e.g. database query
+ * results).
+ *
+ * @param items - The array of items to index.
+ * @param getKey - A function that produces the composite key for each item.
+ *   Must return a string of the form `"id:version"` so that the returned
+ *   `get(id, version)` method can reconstruct it.
+ * @returns An object with a `get(id, version)` method that looks up items
+ *   by reconstructing the composite key. Returns `undefined` if no item
+ *   matches.
+ *
+ * @example
+ * ```ts
+ * const claimLookup = createLookup(claims, (c) => `${c.id}:${c.version}`)
+ * const sourceLookup = createLookup(sources, (s) => `${s.id}:${s.version}`)
+ * const engine = new ArgumentEngine(arg, claimLookup, sourceLookup, ...)
+ * ```
+ */
+export function createLookup(items, getKey) {
+    const map = new Map();
+    for (const item of items) {
+        map.set(getKey(item), item);
+    }
+    return {
+        get(id, version) {
+            return map.get(`${id}:${version}`);
+        },
+    };
+}
+/**
+ * A no-op claim lookup that always returns `undefined`. Use this when the
+ * consumer does not use claims (e.g. an argument with no claim-bound
+ * variables).
+ */
+export const EMPTY_CLAIM_LOOKUP = {
+    get: () => undefined,
+};
+/**
+ * A no-op source lookup that always returns `undefined`. Use this when the
+ * consumer does not use sources.
+ */
+export const EMPTY_SOURCE_LOOKUP = {
+    get: () => undefined,
+};
+/**
+ * A no-op claim-source association lookup that always returns `undefined`
+ * or empty arrays. Use this when the consumer does not use claim-source
+ * associations.
+ */
+export const EMPTY_CLAIM_SOURCE_LOOKUP = {
+    getForClaim: () => [],
+    getForSource: () => [],
+    get: () => undefined,
+};
+//# sourceMappingURL=lookup.js.map

package/dist/lib/utils/lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../../src/lib/utils/lookup.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,YAAY,CACxB,KAAU,EACV,MAA2B;IAE3B,MAAM,GAAG,GAAG,IAAI,GAAG,EAAa,CAAA;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO;QACH,GAAG,CAAC,EAAU,EAAE,OAAe;YAC3B,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC,CAAA;QACtC,CAAC;KACJ,CAAA;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAiB;IAC5C,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAkB;IAC9C,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAuB;IACzD,WAAW,EAAE,GAAG,EAAE,CAAC,EAAE;IACrB,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE;IACtB,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS;CACvB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polintpro/proposit-core",
-  "version": "0.7.3",
+  "version": "0.8.0",
   "description": "Core engine for building and manipulating propositional logic arguments.",
   "license": "MIT",
   "keywords": [