@genesislcap/foundation-utils 14.81.0 → 14.82.0

package/dist/custom-elements.json

@@ -2348,6 +2348,14 @@
             "package": "./json"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./json.types"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -2370,6 +2378,50 @@
       "kind": "javascript-module",
       "path": "src/serializers/json/json.ts",
       "declarations": [
+        {
+          "kind": "function",
+          "name": "customNumberParser",
+          "parameters": [
+            {
+              "name": "value"
+            }
+          ],
+          "description": "A Default Number Parser for deserializing objects.",
+          "privacy": "public"
+        },
+        {
+          "kind": "variable",
+          "name": "defaultJSONSerializerConfig",
+          "type": {
+            "text": "JSONSerializerConfig"
+          },
+          "default": "{\n  parse: (input: any) => parse(input, null, customNumberParser),\n  stringify: (object: any) => stringify(object),\n}",
+          "description": "A Default JSONSerializer Config for serializing and deserializing functions.",
+          "privacy": "public"
+        },
+        {
+          "kind": "class",
+          "description": "",
+          "name": "DefaultJSONSerializer",
+          "members": [
+            {
+              "kind": "field",
+              "name": "serialize"
+            },
+            {
+              "kind": "method",
+              "name": "deserialize",
+              "parameters": [
+                {
+                  "name": "input",
+                  "type": {
+                    "text": "any"
+                  }
+                }
+              ]
+            }
+          ]
+        },
         {
           "kind": "variable",
           "name": "JSONSerializer",
@@ -2378,6 +2430,30 @@
         }
       ],
       "exports": [
+        {
+          "kind": "js",
+          "name": "customNumberParser",
+          "declaration": {
+            "name": "customNumberParser",
+            "module": "src/serializers/json/json.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "defaultJSONSerializerConfig",
+          "declaration": {
+            "name": "defaultJSONSerializerConfig",
+            "module": "src/serializers/json/json.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "DefaultJSONSerializer",
+            "module": "src/serializers/json/json.ts"
+          }
+        },
         {
           "kind": "js",
           "name": "JSONSerializer",
@@ -2388,6 +2464,12 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/serializers/json/json.types.ts",
+      "declarations": [],
+      "exports": []
+    },
     {
       "kind": "javascript-module",
       "path": "src/serializers/json/jsonReplacer.ts",

package/dist/dts/serializers/json/index.d.ts

@@ -1,4 +1,5 @@
 export * from './json';
+export * from './json.types';
 export * from './jsonReplacer';
 export * from './jsonReviver';
 //# sourceMappingURL=index.d.ts.map

package/dist/dts/serializers/json/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/serializers/json/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/serializers/json/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC"}

package/dist/dts/serializers/json/json.d.ts

@@ -1,3 +1,9 @@
+import { JSONSerializerConfig } from './json.types';
+/**
+ * A Default Number Parser for deserializing objects.
+ * @public
+ */
+export declare function customNumberParser(value: any): number | bigint;
 /**
  * An interface representing a JSON serializer.
  * @public
@@ -28,6 +34,23 @@ export interface JSONSerializer {
      */
     deserialize<T = any>(text: string): T;
 }
+/**
+ * A Default JSONSerializer Config for serializing and deserializing functions.
+ * @public
+ */
+export declare const defaultJSONSerializerConfig: JSONSerializerConfig;
+export default class DefaultJSONSerializer implements JSONSerializer {
+    private config;
+    constructor(config?: JSONSerializerConfig);
+    /**
+     * @inheritDoc JSONSerializer.serialize
+     */
+    serialize: (object: any) => string;
+    /**
+     * @inheritDoc JSONSerializer.deserialize
+     */
+    deserialize<T>(input: any): any;
+}
 /**
  * A DI token for the JSON serializer.
  * @public

package/dist/dts/serializers/json/json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../src/serializers/json/json.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC;IAE/B;;;;OAIG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAErD;;;;OAIG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC;IAE7C;;;;OAIG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;CACvC;AA0BD;;;GAGG;AACH,eAAO,MAAM,cAAc,sEAE1B,CAAC"}
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../src/serializers/json/json.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAErE;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,KAAA,mBAQvC;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC;IAE/B;;;;OAIG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAErD;;;;OAIG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC,CAAC;IAE7C;;;;OAIG;IACH,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,oBAGzC,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,qBAAsB,YAAW,cAAc;IACtB,OAAO,CAAC,MAAM;gBAAN,MAAM,uBAA8B;IAExF;;OAEG;IACH,SAAS,WAAY,GAAG,KAAG,MAAM,CAAkC;IAEnE;;OAEG;IACH,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG;CAmB1B;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,sEAE1B,CAAC"}

package/dist/dts/serializers/json/json.types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @internal
+ */
+export declare const BIG_INT_64_BITS = 64;
+/**
+ * Configuration options for the JSONSerializer Config instance.
+ * @public
+ */
+export interface JSONSerializerConfig {
+    parse(text: string, reviver?: (this: any, key: string, value: any) => any): any;
+    parse(text: string, reviver?: (this: any, key: string, value: any) => any, parseNumber?: any): any;
+    stringify(value: any, replacer?: (this: any, key: string, value: any) => any, space?: string | number): string;
+    stringify(value: any, replacer?: (number | string)[] | null, space?: string | number): string;
+}
+/**
+ * Configuration options for the JSONSerializer Config instance.
+ * @internal
+ */
+export declare const JSONSerializerConfig: import("@microsoft/fast-foundation").InterfaceSymbol<JSONSerializerConfig>;
+//# sourceMappingURL=json.types.d.ts.map

package/dist/dts/serializers/json/json.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.types.d.ts","sourceRoot":"","sources":["../../../../src/serializers/json/json.types.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG,GAAG,CAAC;IAChF,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,EACrD,WAAW,CAAC,EAAE,GAAG,GAChB,GAAG,CAAC;IACP,SAAS,CACP,KAAK,EAAE,GAAG,EACV,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG,EACtD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GACtB,MAAM,CAAC;IACV,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CAC/F;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,4EAA6C,CAAC"}

package/dist/esm/serializers/json/index.js

@@ -1,3 +1,4 @@
 export * from './json';
+export * from './json.types';
 export * from './jsonReplacer';
 export * from './jsonReviver';

package/dist/esm/serializers/json/json.js

@@ -1,28 +1,59 @@
-import { DI } from '@microsoft/fast-foundation';
-class DefaultJSONSerializer {
-    constructor() {
+import { __decorate, __param } from "tslib";
+import { DI, optional } from '@microsoft/fast-foundation';
+import { parse, stringify, isInteger } from 'lossless-json';
+import { BIG_INT_64_BITS, JSONSerializerConfig } from './json.types';
+/**
+ * A Default Number Parser for deserializing objects.
+ * @public
+ */
+export function customNumberParser(value) {
+    if (Number.isSafeInteger(+value)) {
+        return Number(value);
+    }
+    if (!isInteger(value)) {
+        return parseFloat(value);
+    }
+    return BigInt.asIntN(BIG_INT_64_BITS, value);
+}
+/**
+ * A Default JSONSerializer Config for serializing and deserializing functions.
+ * @public
+ */
+export const defaultJSONSerializerConfig = {
+    parse: (input) => parse(input, null, customNumberParser),
+    stringify: (object) => stringify(object),
+};
+let DefaultJSONSerializer = class DefaultJSONSerializer {
+    constructor(config = defaultJSONSerializerConfig) {
+        this.config = config;
         /**
-         * Serializes an object to a JSON string using `JSON.stringify`.
-         * @param object - The object to serialize.
-         * @returns The serialized JSON string.
+         * @inheritDoc JSONSerializer.serialize
          */
-        this.serialize = (object) => JSON.stringify(object);
+        this.serialize = (object) => this.config.stringify(object);
     }
     /**
-     * Deserializes a response object from a HTTP request to a JavaScript object using `JSON.parse`.
-     * @param input - The HTTP response object.
-     * @returns A promise that resolves to the deserialized JavaScript object.
+     * @inheritDoc JSONSerializer.deserialize
      */
     deserialize(input) {
+        if (!input) {
+            return Promise.resolve({});
+        }
+        if (typeof input === 'string') {
+            return this.config.parse(input);
+        }
         if (input && input.ok) {
-            return input.text().then((text) => JSON.parse(text));
+            return input.text().then((text) => this.config.parse(text));
         }
         if (input && input.data) {
             input = input.data;
         }
-        return JSON.parse(input);
+        return this.config.parse(input);
     }
-}
+};
+DefaultJSONSerializer = __decorate([
+    __param(0, optional(JSONSerializerConfig))
+], DefaultJSONSerializer);
+export default DefaultJSONSerializer;
 /**
  * A DI token for the JSON serializer.
  * @public

package/dist/esm/serializers/json/json.types.js

@@ -0,0 +1,10 @@
+import { DI } from '@microsoft/fast-foundation';
+/**
+ * @internal
+ */
+export const BIG_INT_64_BITS = 64;
+/**
+ * Configuration options for the JSONSerializer Config instance.
+ * @internal
+ */
+export const JSONSerializerConfig = DI.createInterface();

package/dist/foundation-utils.api.json

@@ -543,6 +543,51 @@
             "endIndex": 4
           }
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-utils!customNumberParser:function(1)",
+          "docComment": "/**\n * A Default Number Parser for deserializing objects.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export declare function customNumberParser(value: "
+            },
+            {
+              "kind": "Content",
+              "text": "any"
+            },
+            {
+              "kind": "Content",
+              "text": "): "
+            },
+            {
+              "kind": "Content",
+              "text": "number | bigint"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/serializers/json/json.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "value",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "customNumberParser"
+        },
         {
           "kind": "Interface",
           "canonicalReference": "@genesislcap/foundation-utils!Database:interface",
@@ -2110,6 +2155,30 @@
             "endIndex": 5
           }
         },
+        {
+          "kind": "Variable",
+          "canonicalReference": "@genesislcap/foundation-utils!defaultJSONSerializerConfig:var",
+          "docComment": "/**\n * A Default JSONSerializer Config for serializing and deserializing functions.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "defaultJSONSerializerConfig: "
+            },
+            {
+              "kind": "Reference",
+              "text": "JSONSerializerConfig",
+              "canonicalReference": "@genesislcap/foundation-utils!JSONSerializerConfig:interface"
+            }
+          ],
+          "fileUrlPath": "src/serializers/json/json.ts",
+          "isReadonly": true,
+          "releaseTag": "Public",
+          "name": "defaultJSONSerializerConfig",
+          "variableTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/foundation-utils!defaultLoggerOptions:var",
@@ -4431,6 +4500,316 @@
             "endIndex": 6
           }
         },
+        {
+          "kind": "Interface",
+          "canonicalReference": "@genesislcap/foundation-utils!JSONSerializerConfig:interface",
+          "docComment": "/**\n * Configuration options for the JSONSerializer Config instance.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export interface JSONSerializerConfig "
+            }
+          ],
+          "fileUrlPath": "src/serializers/json/json.types.ts",
+          "releaseTag": "Public",
+          "name": "JSONSerializerConfig",
+          "preserveMemberOrder": false,
+          "members": [
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-utils!JSONSerializerConfig#parse:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "parse(text: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", reviver?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(this: any, key: string, value: any) => any"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "any"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 6
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "text",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "reviver",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "parse"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-utils!JSONSerializerConfig#parse:member(2)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "parse(text: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", reviver?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(this: any, key: string, value: any) => any"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", parseNumber?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "any"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "any"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 2,
+              "parameters": [
+                {
+                  "parameterName": "text",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "reviver",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                },
+                {
+                  "parameterName": "parseNumber",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "parse"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-utils!JSONSerializerConfig#stringify:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "stringify(value: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "any"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", replacer?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(this: any, key: string, value: any) => any"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", space?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string | number"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "value",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "replacer",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                },
+                {
+                  "parameterName": "space",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "stringify"
+            },
+            {
+              "kind": "MethodSignature",
+              "canonicalReference": "@genesislcap/foundation-utils!JSONSerializerConfig#stringify:member(2)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "stringify(value: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "any"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", replacer?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "(number | string)[] | null"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", space?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string | number"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isOptional": false,
+              "returnTypeTokenRange": {
+                "startIndex": 7,
+                "endIndex": 8
+              },
+              "releaseTag": "Public",
+              "overloadIndex": 2,
+              "parameters": [
+                {
+                  "parameterName": "value",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "replacer",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                },
+                {
+                  "parameterName": "space",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 5,
+                    "endIndex": 6
+                  },
+                  "isOptional": true
+                }
+              ],
+              "name": "stringify"
+            }
+          ],
+          "extendsTokenRanges": []
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/foundation-utils!layoutCacheDocument:var",

package/dist/foundation-utils.d.ts

@@ -32,6 +32,11 @@ export declare let API_HOST: string;
  */
 export declare function assureDesignSystem(module: DesignSystemModule): DesignSystemModule;
 
+/**
+ * @internal
+ */
+export declare const BIG_INT_64_BITS = 64;
+
 /**
  * @public
  */
@@ -77,6 +82,12 @@ export declare function createLogger(name: string, options?: LoggerOptions): Log
  */
 export declare const createObserver: <EventType>() => Observer<EventType>;
 
+/**
+ * A Default Number Parser for deserializing objects.
+ * @public
+ */
+export declare function customNumberParser(value: any): number | bigint;
+
 /**
  * Represents a database with basic CRUD operations.
  * @public
@@ -218,6 +229,12 @@ export declare class DefaultErrorMap<TErrorDetailMap extends ErrorDetailMap> imp
  */
 export declare const defaultEventMap: Map<string, EventName>;
 
+/**
+ * A Default JSONSerializer Config for serializing and deserializing functions.
+ * @public
+ */
+export declare const defaultJSONSerializerConfig: JSONSerializerConfig;
+
 /**
  * The default logger options.
  * @public
@@ -509,6 +526,23 @@ export declare interface JSONSerializer {
  */
 export declare const JSONSerializer: InterfaceSymbol<JSONSerializer>;
 
+/**
+ * Configuration options for the JSONSerializer Config instance.
+ * @public
+ */
+export declare interface JSONSerializerConfig {
+    parse(text: string, reviver?: (this: any, key: string, value: any) => any): any;
+    parse(text: string, reviver?: (this: any, key: string, value: any) => any, parseNumber?: any): any;
+    stringify(value: any, replacer?: (this: any, key: string, value: any) => any, space?: string | number): string;
+    stringify(value: any, replacer?: (number | string)[] | null, space?: string | number): string;
+}
+
+/**
+ * Configuration options for the JSONSerializer Config instance.
+ * @internal
+ */
+export declare const JSONSerializerConfig: InterfaceSymbol<JSONSerializerConfig>;
+
 /**
  * Signifies the internal document fragment that stores the master copy
  * of the layout item, not part of the DOM.

package/docs/api/foundation-utils.customnumberparser.md

@@ -0,0 +1,24 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [customNumberParser](./foundation-utils.customnumberparser.md)
+
+## customNumberParser() function
+
+A Default Number Parser for deserializing objects.
+
+**Signature:**
+
+```typescript
+export declare function customNumberParser(value: any): number | bigint;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  value | any |  |
+
+**Returns:**
+
+number \| bigint
+

package/docs/api/foundation-utils.defaultjsonserializerconfig.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [defaultJSONSerializerConfig](./foundation-utils.defaultjsonserializerconfig.md)
+
+## defaultJSONSerializerConfig variable
+
+A Default JSONSerializer Config for serializing and deserializing functions.
+
+**Signature:**
+
+```typescript
+defaultJSONSerializerConfig: JSONSerializerConfig
+```

package/docs/api/foundation-utils.jsonserializerconfig.md

@@ -0,0 +1,23 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [JSONSerializerConfig](./foundation-utils.jsonserializerconfig.md)
+
+## JSONSerializerConfig interface
+
+Configuration options for the JSONSerializer Config instance.
+
+**Signature:**
+
+```typescript
+export interface JSONSerializerConfig 
+```
+
+## Methods
+
+|  Method | Description |
+|  --- | --- |
+|  [parse(text, reviver)](./foundation-utils.jsonserializerconfig.parse.md) |  |
+|  [parse(text, reviver, parseNumber)](./foundation-utils.jsonserializerconfig.parse_1.md) |  |
+|  [stringify(value, replacer, space)](./foundation-utils.jsonserializerconfig.stringify.md) |  |
+|  [stringify(value, replacer, space)](./foundation-utils.jsonserializerconfig.stringify_1.md) |  |
+

package/docs/api/foundation-utils.jsonserializerconfig.parse.md

@@ -0,0 +1,23 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [JSONSerializerConfig](./foundation-utils.jsonserializerconfig.md) &gt; [parse](./foundation-utils.jsonserializerconfig.parse.md)
+
+## JSONSerializerConfig.parse() method
+
+**Signature:**
+
+```typescript
+parse(text: string, reviver?: (this: any, key: string, value: any) => any): any;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  text | string |  |
+|  reviver | (this: any, key: string, value: any) =&gt; any | _(Optional)_ |
+
+**Returns:**
+
+any
+

package/docs/api/foundation-utils.jsonserializerconfig.parse_1.md

@@ -0,0 +1,24 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [JSONSerializerConfig](./foundation-utils.jsonserializerconfig.md) &gt; [parse](./foundation-utils.jsonserializerconfig.parse_1.md)
+
+## JSONSerializerConfig.parse() method
+
+**Signature:**
+
+```typescript
+parse(text: string, reviver?: (this: any, key: string, value: any) => any, parseNumber?: any): any;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  text | string |  |
+|  reviver | (this: any, key: string, value: any) =&gt; any | _(Optional)_ |
+|  parseNumber | any | _(Optional)_ |
+
+**Returns:**
+
+any
+

package/docs/api/foundation-utils.jsonserializerconfig.stringify.md

@@ -0,0 +1,24 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [JSONSerializerConfig](./foundation-utils.jsonserializerconfig.md) &gt; [stringify](./foundation-utils.jsonserializerconfig.stringify.md)
+
+## JSONSerializerConfig.stringify() method
+
+**Signature:**
+
+```typescript
+stringify(value: any, replacer?: (this: any, key: string, value: any) => any, space?: string | number): string;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  value | any |  |
+|  replacer | (this: any, key: string, value: any) =&gt; any | _(Optional)_ |
+|  space | string \| number | _(Optional)_ |
+
+**Returns:**
+
+string
+

package/docs/api/foundation-utils.jsonserializerconfig.stringify_1.md

@@ -0,0 +1,24 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [JSONSerializerConfig](./foundation-utils.jsonserializerconfig.md) &gt; [stringify](./foundation-utils.jsonserializerconfig.stringify_1.md)
+
+## JSONSerializerConfig.stringify() method
+
+**Signature:**
+
+```typescript
+stringify(value: any, replacer?: (number | string)[] | null, space?: string | number): string;
+```
+
+## Parameters
+
+|  Parameter | Type | Description |
+|  --- | --- | --- |
+|  value | any |  |
+|  replacer | (number \| string)\[\] \| null | _(Optional)_ |
+|  space | string \| number | _(Optional)_ |
+
+**Returns:**
+
+string
+

package/docs/api/foundation-utils.md

@@ -28,6 +28,7 @@
 |  --- | --- |
 |  [assureDesignSystem(module)](./foundation-utils.assuredesignsystem.md) |  |
 |  [createLogger(name, options)](./foundation-utils.createlogger.md) | Creates a logger with the given name and options. |
+|  [customNumberParser(value)](./foundation-utils.customnumberparser.md) | A Default Number Parser for deserializing objects. |
 |  [formatDateTimestamp(timestamp)](./foundation-utils.formatdatetimestamp.md) | Formats \[DATE\] UNIX Timestamps (without time) to readable strings |
 |  [formatDateTimeTimestamp(timestamp)](./foundation-utils.formatdatetimetimestamp.md) | Formats \[DATETIME\] UNIX Timestamps (with time) to readable strings |
 |  [formatTimestamp(timestamp, withTime)](./foundation-utils.formattimestamp.md) | Formats \[DATE\|DATETIME\] Unix Timestamps to readable strings |
@@ -47,6 +48,7 @@
 |  [DTOMapper](./foundation-utils.dtomapper.md) |  |
 |  [ErrorMap](./foundation-utils.errormap.md) |  |
 |  [JSONSerializer](./foundation-utils.jsonserializer.md) | An interface representing a JSON serializer. |
+|  [JSONSerializerConfig](./foundation-utils.jsonserializerconfig.md) | Configuration options for the JSONSerializer Config instance. |
 |  [Logger](./foundation-utils.logger.md) | A logger that extends the <code>Consola</code> logger. |
 |  [LoggerOptions](./foundation-utils.loggeroptions.md) | Options for creating a logger. |
 |  [Observer](./foundation-utils.observer.md) | Represents an event observer that manages the subscription and publication of events. |
@@ -73,6 +75,7 @@
 |  [DEFAULT\_PASSWORD](./foundation-utils.default_password.md) | The default Password value, used in auth/login flow \[<code>genesislcap-foundation-login</code>\](https://link-to-docs). |
 |  [DEFAULT\_USER](./foundation-utils.default_user.md) | The default Username value, used in auth/login flow \[<code>genesislcap-foundation-login</code>\](https://link-to-docs). |
 |  [defaultEventMap](./foundation-utils.defaulteventmap.md) | A map that associates specific HTML element tags with their corresponding default event names. |
+|  [defaultJSONSerializerConfig](./foundation-utils.defaultjsonserializerconfig.md) | A Default JSONSerializer Config for serializing and deserializing functions. |
 |  [defaultLoggerOptions](./foundation-utils.defaultloggeroptions.md) | The default logger options. |
 |  [FORCE\_HTTP](./foundation-utils.force_http.md) | The path to a JSON config file for the HTTP mode. |
 |  [getFontMixin](./foundation-utils.getfontmixin.md) | Generates a CSS mixin for the specified font family, style, and weight. |

package/docs/api-report.md

@@ -27,6 +27,11 @@ export let API_HOST: string;
 // @public (undocumented)
 export function assureDesignSystem(module: DesignSystemModule): DesignSystemModule;
 
+// Warning: (ae-internal-missing-underscore) The name "BIG_INT_64_BITS" should be prefixed with an underscore because the declaration is marked as @internal
+//
+// @internal (undocumented)
+export const BIG_INT_64_BITS = 64;
+
 // @public (undocumented)
 export type ConstructableLifecycleHandler = Constructable<FASTElement & HTMLElement>;
 
@@ -45,6 +50,9 @@ export function createLogger(name: string, options?: LoggerOptions): Logger;
 // @public
 export const createObserver: <EventType>() => Observer<EventType>;
 
+// @public
+export function customNumberParser(value: any): number | bigint;
+
 // @public
 export interface Database<T extends DatabaseRecord> {
     // (undocumented)
@@ -140,6 +148,9 @@ export class DefaultErrorMap<TErrorDetailMap extends ErrorDetailMap> implements
 // @public
 export const defaultEventMap: Map<string, EventName>;
 
+// @public
+export const defaultJSONSerializerConfig: JSONSerializerConfig;
+
 // @public
 export const defaultLoggerOptions: LoggerOptions;
 
@@ -298,6 +309,23 @@ export interface JSONSerializer {
 // @public
 export const JSONSerializer: InterfaceSymbol<JSONSerializer>;
 
+// Warning: (ae-internal-mixed-release-tag) Mixed release tags are not allowed for "JSONSerializerConfig" because one of its declarations is marked as @internal
+//
+// @public
+export interface JSONSerializerConfig {
+    // (undocumented)
+    parse(text: string, reviver?: (this: any, key: string, value: any) => any): any;
+    // (undocumented)
+    parse(text: string, reviver?: (this: any, key: string, value: any) => any, parseNumber?: any): any;
+    // (undocumented)
+    stringify(value: any, replacer?: (this: any, key: string, value: any) => any, space?: string | number): string;
+    // (undocumented)
+    stringify(value: any, replacer?: (number | string)[] | null, space?: string | number): string;
+}
+
+// @internal
+export const JSONSerializerConfig: InterfaceSymbol<JSONSerializerConfig>;
+
 // Warning: (ae-internal-missing-underscore) The name "LayoutCacheContainer" should be prefixed with an underscore because the declaration is marked as @internal
 //
 // @internal

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.81.0",
+  "version": "14.82.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -16,16 +16,17 @@
     "test": "genx test"
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.81.0",
-    "@genesislcap/genx": "14.81.0",
+    "@genesislcap/foundation-testing": "14.82.0",
+    "@genesislcap/genx": "14.82.0",
     "rimraf": "^3.0.2"
   },
   "dependencies": {
-    "@genesislcap/foundation-logger": "14.81.0",
+    "@genesislcap/foundation-logger": "14.82.0",
     "@microsoft/fast-components": "^2.21.3",
     "@microsoft/fast-element": "^1.7.0",
     "@microsoft/fast-foundation": "^2.33.2",
     "consola": "^2.15.3",
+    "lossless-json": "^2.0.11",
     "tslib": "^2.3.1",
     "uuid": "^8.3.2"
   },
@@ -38,5 +39,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "6f2d59820f20c84c0910281cc172931db6ce7543"
+  "gitHead": "69108b95942ed1e47c3cf1eaf9fd3c3ed9188de0"
 }