@longlast/function-provenance 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -11,7 +11,14 @@ export interface FunctionProvenance {
     displayName: string;
     [$nonUserConstructible]: true;
 }
+type UnknownFunction = (...args: never) => unknown;
 export declare function getBoundArguments(f: AnyFunction): unknown[];
 export declare function getUnapplied(f: AnyFunction): UnknownFunction;
-type UnknownFunction = (...args: never) => unknown;
+/**
+ * Transfers provenance information from the `source` function to `dest`, which
+ * is assumed to be a partial application of `source`.
+ *
+ * @param args the arguments that were applied to create `dest` from `source`.
+ */
+export declare function trackProvenance<F extends AnyFunction>(source: UnknownFunction, args: readonly unknown[], dest: F): F;
 export {};

package/dist/index.js

@@ -9,3 +9,24 @@ export function getBoundArguments(f) {
 export function getUnapplied(f) {
     return f[$unapplied] ?? f;
 }
+/**
+ * Transfers provenance information from the `source` function to `dest`, which
+ * is assumed to be a partial application of `source`.
+ *
+ * @param args the arguments that were applied to create `dest` from `source`.
+ */
+export function trackProvenance(source, args, dest) {
+    unsafeNarrow(dest);
+    dest.displayName = getName(source);
+    dest[$getBoundArguments] = () => getBoundArguments(source).concat(args);
+    dest[$unapplied] = getUnapplied(source);
+    return dest;
+}
+// TODO: unsafeNarrow is duplicated in equals.
+function unsafeNarrow(value) {
+    value;
+}
+// TODO: getName is duplicated.
+function getName(f) {
+    return f.displayName ?? f.name;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longlast/function-provenance",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Imbues partially-applied functions with knowledge of their origins",
   "homepage": "https://longlast.js.org/",
   "license": "MIT",