@lionweb/core 0.7.0-beta.22 → 0.7.0-beta.23

package/CHANGELOG.md

@@ -34,6 +34,7 @@
 * Expose feature resolution, through the `featureResolversFor` function (and associated types), which performs proper checking.
   This avoids undebuggable `undefined` dereferencing at runtime in `deltaDeserializer` and `eventToDeltaTranslator` functions.
 * Package `src/` again (— i.e., don't ignore for NPM packaging.)
+* Add `serializedRef` function that serializes a single reference target.
 
 
 ## 0.6.12

package/dist/references.d.ts

@@ -1,4 +1,5 @@
 import { LionWebId } from "@lionweb/json";
+import { Node } from "./types.js";
 /**
  * The `unresolved` symbol indicates a reference value which hasn't been resolved yet.
  * It differs from an unset (`undefined`) value.
@@ -9,7 +10,7 @@ export declare const unresolved: null;
  */
 export type SingleRef<T> = typeof unresolved | T;
 /**
- * Checks whether a given (at most) single-valued reference actually refers to something.
+ * @return whether a given (at most) single-valued reference actually refers to something.
  */
 export declare const isRef: <T>(ref?: SingleRef<T>) => ref is T;
 /**
@@ -20,4 +21,8 @@ export type MultiRef<T> = T[];
  * A type that expresses a value is either an {@link LionWebId} or a value to indicate that resolution to a node previously failed.
  */
 export type IdOrUnresolved = LionWebId | typeof unresolved;
+/**
+ * @return the serialization of the given {@link SingleRef single reference target}, as a {@link LionWebId LionWeb ID}.
+ */
+export declare const serializedRef: <NT extends Node>(ref: SingleRef<NT>) => LionWebId | typeof unresolved;
 //# sourceMappingURL=references.d.ts.map

package/dist/references.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAGzC;;;GAGG;AACH,eAAO,MAAM,UAAU,MAAO,CAAA;AAE9B;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,OAAO,UAAU,GAAG,CAAC,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,KAAG,GAAG,IAAI,CACV,CAAA;AAE3C;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAA;AAG7B;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,UAAU,CAAC"}
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGjC;;;GAGG;AACH,eAAO,MAAM,UAAU,MAAO,CAAA;AAE9B;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,OAAO,UAAU,GAAG,CAAC,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,MAAM,SAAS,CAAC,CAAC,CAAC,KAAG,GAAG,IAAI,CACV,CAAA;AAE3C;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAA;AAG7B;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,UAAU,CAAC;AAG3D;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,EAAE,SAAS,IAAI,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC,KAAG,SAAS,GAAG,OAAO,UAC3C,CAAA"}

package/dist/references.js

@@ -4,7 +4,11 @@
  */
 export const unresolved = null;
 /**
- * Checks whether a given (at most) single-valued reference actually refers to something.
+ * @return whether a given (at most) single-valued reference actually refers to something.
  */
 export const isRef = (ref) => ref !== undefined && ref !== unresolved;
+/**
+ * @return the serialization of the given {@link SingleRef single reference target}, as a {@link LionWebId LionWeb ID}.
+ */
+export const serializedRef = (ref) => ref === unresolved ? unresolved : ref.id;
 //# sourceMappingURL=references.js.map

package/dist/references.js.map

@@ -1 +1 @@
-{"version":3,"file":"references.js","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAA;AAO9B;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,GAAkB,EAAY,EAAE,CACrD,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,UAAU,CAAA"}
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../src/references.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAA;AAO9B;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,GAAkB,EAAY,EAAE,CACrD,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,UAAU,CAAA;AAc3C;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAkB,GAAkB,EAAiC,EAAE,CAChG,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lionweb/core",
-    "version": "0.7.0-beta.22",
+    "version": "0.7.0-beta.23",
     "description": "LionWeb core for {Java|Type}Script",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -27,7 +27,7 @@
         "release": "npm publish"
     },
     "dependencies": {
-        "@lionweb/json": "0.7.0-beta.22",
-        "@lionweb/ts-utils": "0.7.0-beta.22"
+        "@lionweb/json": "0.7.0-beta.23",
+        "@lionweb/ts-utils": "0.7.0-beta.23"
     }
 }

package/src/references.ts

@@ -1,4 +1,5 @@
 import { LionWebId } from "@lionweb/json"
+import { Node } from "./types.js"
 
 
 /**
@@ -13,7 +14,7 @@ export const unresolved = null
 export type SingleRef<T> = typeof unresolved | T
 
 /**
- * Checks whether a given (at most) single-valued reference actually refers to something.
+ * @return whether a given (at most) single-valued reference actually refers to something.
  */
 export const isRef = <T>(ref?: SingleRef<T>): ref is T =>
     ref !== undefined && ref !== unresolved
@@ -29,3 +30,10 @@ export type MultiRef<T> = T[]
  */
 export type IdOrUnresolved = LionWebId | typeof unresolved;
 
+
+/**
+ * @return the serialization of the given {@link SingleRef single reference target}, as a {@link LionWebId LionWeb ID}.
+ */
+export const serializedRef = <NT extends Node>(ref: SingleRef<NT>): LionWebId | typeof unresolved =>
+    ref === unresolved ? unresolved : ref.id
+