ig-serialize 1.1.0 → 1.2.0

package/README.md

@@ -7,6 +7,9 @@ This extends the default JSON serialization adding the following:
 - Function serialization (off by default)
 - Deep and partial-deep cleen object copy
 
+Possible differences to JSON output:
+- Repeating long strings and BigInts can be referenced instead of 
+  reincluded in the output.
 
 
 ## Motivation
@@ -20,6 +23,13 @@ and tooling design, basic parsing, among others.
 
 ## Installation
 
+```shell
+$ npm install ig-serilaize
+```
+
+Or just download and drop [serialize.js](serialize.js) into your code.
+
+
 
 ## Introduction
 
@@ -38,6 +48,7 @@ loosing:
 Thus, care must be taken when serializing structures containing function.
 
 
+
 ## API
 
 ### `serialize(..)` / `eJSON.stringify(..)`
@@ -49,6 +60,20 @@ Thus, care must be taken when serializing structures containing function.
 ### `partialDeepCopy(..)`
 
 
+### `MIN_LENGTH_REF` / `<options>.min_length_ref` 
+
+Defines the default minimum length of repeating string or bin-int to 
+include as a reference in the output.
+
+If set to `0`, referencing will be disabled.
+
+Default: 96  
+
+
+### `DEBUG`
+
+
+
 ## Format
 
 The output of `.serialize(..)` is a strict superset of [standard JSON](https://www.json.org/json-en.html), 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ig-serialize",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "experimental extended json serializaion...",
   "main": "serialize.js",
   "scripts": {
@@ -10,7 +10,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/flynx/serialize.js"
+    "url": "git+https://github.com/flynx/serialize.js.git"
   },
   "keywords": [
     "JSON",

package/serialize.js

@@ -77,7 +77,7 @@ var debug = {
 
 //---------------------------------------------------------------------
 
-module.STRING_LENGTH_REF = REFERENCE.length * 8
+module.MIN_LENGTH_REF = REFERENCE.length * 16
 
 
 //
@@ -144,9 +144,13 @@ module.STRING_LENGTH_REF = REFERENCE.length * 8
 var _serialize = 
 module._serialize = 
 function(obj, path=[], seen=new Map(), indent, depth=0, options={}){
-	var string_length_ref = 
-		options.string_length_ref 
-			?? module.STRING_LENGTH_REF
+	var min_length_ref = 
+		options.min_length_ref 
+			?? module.MIN_LENGTH_REF
+	min_length_ref = 
+		min_length_ref <= 0 ? 
+			Infinity 
+			: min_length_ref
 
 	// reference...
 	var p = seen.get(obj)
@@ -171,12 +175,14 @@ function(obj, path=[], seen=new Map(), indent, depth=0, options={}){
 	// long strings...
 	// NOTE: this saves on output size...
 	if(typeof(obj) == 'string' 
-			&& obj.length > string_length_ref){
+			&& obj.length > min_length_ref){
 		seen.set(obj, path) }
 	// BigInt...
 	if(typeof(obj) == 'bigint'){
-		seen.set(obj, path)
-		return obj.toString() +'n' }
+		var res = obj.toString() +'n' 
+		if(res.length > min_length_ref){
+			seen.set(obj, path) }
+		return res }
 
 	// atomics...
 	// NOTE: these are not stored in seen thus are not re-referenced...