@genesislcap/foundation-utils 14.370.1-alpha-fa13546.0 → 14.371.0-FUI-2456.1

package/dist/custom-elements.json

@@ -474,6 +474,126 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/design-system/design-system.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "assureDesignSystem",
+          "return": {
+            "type": {
+              "text": "DesignSystemModule"
+            }
+          },
+          "parameters": [
+            {
+              "name": "module",
+              "type": {
+                "text": "DesignSystemModule"
+              }
+            }
+          ],
+          "description": "assureDesignSystem.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "getCurrentDesignSystem",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "The starting HTML element"
+            },
+            {
+              "name": "fallbackPrefix",
+              "type": {
+                "text": "string"
+              },
+              "description": "The prefix to fallback to if the provider is not available"
+            }
+          ],
+          "description": "Get the current design system provider element and prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "getCurrentDesignSystemPrefix",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "element",
+              "type": {
+                "text": "HTMLElement"
+              },
+              "description": "The starting HTML element"
+            },
+            {
+              "name": "fallbackPrefix",
+              "type": {
+                "text": "string"
+              },
+              "description": "The prefix to fallback to if the provider is not available"
+            }
+          ],
+          "description": "Get the current design system prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "assureDesignSystem",
+          "declaration": {
+            "name": "assureDesignSystem",
+            "module": "src/design-system/design-system.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getCurrentDesignSystem",
+          "declaration": {
+            "name": "getCurrentDesignSystem",
+            "module": "src/design-system/design-system.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "getCurrentDesignSystemPrefix",
+          "declaration": {
+            "name": "getCurrentDesignSystemPrefix",
+            "module": "src/design-system/design-system.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/design-system/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./design-system"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/env/index.ts",
@@ -949,126 +1069,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/design-system/design-system.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "assureDesignSystem",
-          "return": {
-            "type": {
-              "text": "DesignSystemModule"
-            }
-          },
-          "parameters": [
-            {
-              "name": "module",
-              "type": {
-                "text": "DesignSystemModule"
-              }
-            }
-          ],
-          "description": "assureDesignSystem.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "getCurrentDesignSystem",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
-          "parameters": [
-            {
-              "name": "element",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "The starting HTML element"
-            },
-            {
-              "name": "fallbackPrefix",
-              "type": {
-                "text": "string"
-              },
-              "description": "The prefix to fallback to if the provider is not available"
-            }
-          ],
-          "description": "Get the current design system provider element and prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
-          "privacy": "public"
-        },
-        {
-          "kind": "function",
-          "name": "getCurrentDesignSystemPrefix",
-          "return": {
-            "type": {
-              "text": ""
-            }
-          },
-          "parameters": [
-            {
-              "name": "element",
-              "type": {
-                "text": "HTMLElement"
-              },
-              "description": "The starting HTML element"
-            },
-            {
-              "name": "fallbackPrefix",
-              "type": {
-                "text": "string"
-              },
-              "description": "The prefix to fallback to if the provider is not available"
-            }
-          ],
-          "description": "Get the current design system prefix by checking available providers.\nIf no provider is found, falls back to the provided prefix.",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "assureDesignSystem",
-          "declaration": {
-            "name": "assureDesignSystem",
-            "module": "src/design-system/design-system.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getCurrentDesignSystem",
-          "declaration": {
-            "name": "getCurrentDesignSystem",
-            "module": "src/design-system/design-system.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "getCurrentDesignSystemPrefix",
-          "declaration": {
-            "name": "getCurrentDesignSystemPrefix",
-            "module": "src/design-system/design-system.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/design-system/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./design-system"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/error/errorMap.ts",
@@ -3489,6 +3489,49 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/deepMerge.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "deepMerge",
+          "return": {
+            "type": {
+              "text": ""
+            }
+          },
+          "parameters": [
+            {
+              "name": "target",
+              "type": {
+                "text": "T"
+              },
+              "description": "The target object to merge into (defaults/base values)"
+            },
+            {
+              "name": "source",
+              "type": {
+                "text": "Partial<T>"
+              },
+              "description": "The source object to merge from (overrides)"
+            }
+          ],
+          "description": "Deep merges two objects, with source values taking precedence over target values.\nArrays are replaced (not merged), and null/undefined values in source are preserved.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "deepMerge",
+          "declaration": {
+            "name": "deepMerge",
+            "module": "src/utils/deepMerge.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/delay.ts",
@@ -3623,6 +3666,14 @@
       "path": "src/utils/index.ts",
       "declarations": [],
       "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./deepMerge"
+          }
+        },
         {
           "kind": "js",
           "name": "*",

package/dist/dts/utils/deepMerge.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Deep merges two objects, with source values taking precedence over target values.
+ * Arrays are replaced (not merged), and null/undefined values in source are preserved.
+ *
+ * @param target - The target object to merge into (defaults/base values)
+ * @param source - The source object to merge from (overrides)
+ * @returns A new merged object with source values taking precedence
+ * @public
+ * @example
+ * ```ts
+ * const defaults = { a: 1, b: { c: 2, d: 3 } };
+ * const overrides = { b: { c: 4 } };
+ * const merged = deepMerge(defaults, overrides);
+ * // Result: { a: 1, b: { c: 4, d: 3 } }
+ * ```
+ */
+export declare const deepMerge: <T extends Record<string, any>>(target: T, source: Partial<T>) => T;
+//# sourceMappingURL=deepMerge.d.ts.map

package/dist/dts/utils/deepMerge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepMerge.d.ts","sourceRoot":"","sources":["../../../src/utils/deepMerge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,KAAG,CAsCxF,CAAC"}

package/dist/dts/utils/index.d.ts

@@ -1,3 +1,4 @@
+export * from './deepMerge';
 export * from './delay';
 export * from './dom';
 export * from './logger';

package/dist/dts/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC"}

package/dist/esm/utils/deepMerge.js

@@ -0,0 +1,48 @@
+/**
+ * Deep merges two objects, with source values taking precedence over target values.
+ * Arrays are replaced (not merged), and null/undefined values in source are preserved.
+ *
+ * @param target - The target object to merge into (defaults/base values)
+ * @param source - The source object to merge from (overrides)
+ * @returns A new merged object with source values taking precedence
+ * @public
+ * @example
+ * ```ts
+ * const defaults = { a: 1, b: { c: 2, d: 3 } };
+ * const overrides = { b: { c: 4 } };
+ * const merged = deepMerge(defaults, overrides);
+ * // Result: { a: 1, b: { c: 4, d: 3 } }
+ * ```
+ */
+export const deepMerge = (target, source) => {
+    const output = structuredClone(target);
+    if (!source || typeof source !== 'object' || Array.isArray(source)) {
+        return source !== undefined ? source : output;
+    }
+    Object.keys(source).forEach((key) => {
+        const sourceValue = source[key];
+        const targetValue = output[key];
+        // If source value is null or undefined, skip it (preserve target value)
+        if (sourceValue === null || sourceValue === undefined) {
+            return;
+        }
+        // Type guard for Date check
+        const isDate = (value) => value instanceof Date;
+        // If both are plain objects (not arrays, dates, etc.), recursively merge
+        if (sourceValue &&
+            typeof sourceValue === 'object' &&
+            !Array.isArray(sourceValue) &&
+            !isDate(sourceValue) &&
+            targetValue &&
+            typeof targetValue === 'object' &&
+            !Array.isArray(targetValue) &&
+            !isDate(targetValue)) {
+            output[key] = deepMerge(targetValue, sourceValue);
+        }
+        else {
+            // Otherwise, source value overrides target value
+            output[key] = sourceValue;
+        }
+    });
+    return output;
+};

package/dist/esm/utils/index.js

@@ -1,3 +1,4 @@
+export * from './deepMerge';
 export * from './delay';
 export * from './dom';
 export * from './logger';

package/dist/foundation-utils.api.json

@@ -1811,6 +1811,94 @@
           ],
           "name": "decodeFromBase64WithPrefix"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-utils!deepMerge:function(1)",
+          "docComment": "/**\n * Deep merges two objects, with source values taking precedence over target values. Arrays are replaced (not merged), and null/undefined values in source are preserved.\n *\n * @param target - The target object to merge into (defaults/base values)\n *\n * @param source - The source object to merge from (overrides)\n *\n * @returns A new merged object with source values taking precedence\n *\n * @example\n * ```ts\n * const defaults = { a: 1, b: { c: 2, d: 3 } };\n * const overrides = { b: { c: 4 } };\n * const merged = deepMerge(defaults, overrides);\n * // Result: { a: 1, b: { c: 4, d: 3 } }\n * ```\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "deepMerge: <T extends "
+            },
+            {
+              "kind": "Reference",
+              "text": "Record",
+              "canonicalReference": "!Record:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<string, any>"
+            },
+            {
+              "kind": "Content",
+              "text": ">(target: "
+            },
+            {
+              "kind": "Content",
+              "text": "T"
+            },
+            {
+              "kind": "Content",
+              "text": ", source: "
+            },
+            {
+              "kind": "Reference",
+              "text": "Partial",
+              "canonicalReference": "!Partial:type"
+            },
+            {
+              "kind": "Content",
+              "text": "<T>"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Content",
+              "text": "T"
+            }
+          ],
+          "fileUrlPath": "src/utils/deepMerge.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 9,
+            "endIndex": 10
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "target",
+              "parameterTypeTokenRange": {
+                "startIndex": 4,
+                "endIndex": 5
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "source",
+              "parameterTypeTokenRange": {
+                "startIndex": 6,
+                "endIndex": 8
+              },
+              "isOptional": false
+            }
+          ],
+          "typeParameters": [
+            {
+              "typeParameterName": "T",
+              "constraintTokenRange": {
+                "startIndex": 1,
+                "endIndex": 3
+              },
+              "defaultTypeTokenRange": {
+                "startIndex": 0,
+                "endIndex": 0
+              }
+            }
+          ],
+          "name": "deepMerge"
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/foundation-utils!DEFAULT_ORGANISATION:var",

package/dist/foundation-utils.d.ts

@@ -225,6 +225,24 @@ export declare const decodeFromBase64: (base64Value: string) => string | ArrayBu
  */
 export declare const decodeFromBase64WithPrefix: (value: string) => string | ArrayBuffer;
 
+/**
+ * Deep merges two objects, with source values taking precedence over target values.
+ * Arrays are replaced (not merged), and null/undefined values in source are preserved.
+ *
+ * @param target - The target object to merge into (defaults/base values)
+ * @param source - The source object to merge from (overrides)
+ * @returns A new merged object with source values taking precedence
+ * @public
+ * @example
+ * ```ts
+ * const defaults = { a: 1, b: { c: 2, d: 3 } };
+ * const overrides = { b: { c: 4 } };
+ * const merged = deepMerge(defaults, overrides);
+ * // Result: { a: 1, b: { c: 4, d: 3 } }
+ * ```
+ */
+export declare const deepMerge: <T extends Record<string, any>>(target: T, source: Partial<T>) => T;
+
 /**
  * The default Organisation value, used in auth/login flow [`genesislcap-foundation-login`](https://link-to-docs).
  * @remarks Optional.

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

@@ -0,0 +1,82 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [deepMerge](./foundation-utils.deepmerge.md)
+
+## deepMerge() function
+
+Deep merges two objects, with source values taking precedence over target values. Arrays are replaced (not merged), and null/undefined values in source are preserved.
+
+**Signature:**
+
+```typescript
+deepMerge: <T extends Record<string, any>>(target: T, source: Partial<T>) => T
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+target
+
+
+</td><td>
+
+T
+
+
+</td><td>
+
+The target object to merge into (defaults/base values)
+
+
+</td></tr>
+<tr><td>
+
+source
+
+
+</td><td>
+
+Partial&lt;T&gt;
+
+
+</td><td>
+
+The source object to merge from (overrides)
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+T
+
+A new merged object with source values taking precedence
+
+## Example
+
+
+```ts
+const defaults = { a: 1, b: { c: 2, d: 3 } };
+const overrides = { b: { c: 4 } };
+const merged = deepMerge(defaults, overrides);
+// Result: { a: 1, b: { c: 4, d: 3 } }
+```
+

package/docs/api/foundation-utils.md

@@ -258,6 +258,17 @@ Decodes a value from base64.
 Decodes a value from base64 with a prefix.
 
 
+</td></tr>
+<tr><td>
+
+[deepMerge(target, source)](./foundation-utils.deepmerge.md)
+
+
+</td><td>
+
+Deep merges two objects, with source values taking precedence over target values. Arrays are replaced (not merged), and null/undefined values in source are preserved.
+
+
 </td></tr>
 <tr><td>
 

package/docs/api-report.md.api.md

@@ -143,6 +143,9 @@ export const decodeFromBase64: (base64Value: string) => string | ArrayBuffer;
 // @public
 export const decodeFromBase64WithPrefix: (value: string) => string | ArrayBuffer;
 
+// @public
+export const deepMerge: <T extends Record<string, any>>(target: T, source: Partial<T>) => T;
+
 // @public
 export let DEFAULT_ORGANISATION: string;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.370.1-alpha-fa13546.0",
+  "version": "14.371.0-FUI-2456.1",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -27,18 +27,18 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.370.1-alpha-fa13546.0",
-    "@genesislcap/genx": "14.370.1-alpha-fa13546.0",
-    "@genesislcap/rollup-builder": "14.370.1-alpha-fa13546.0",
-    "@genesislcap/ts-builder": "14.370.1-alpha-fa13546.0",
-    "@genesislcap/uvu-playwright-builder": "14.370.1-alpha-fa13546.0",
-    "@genesislcap/vite-builder": "14.370.1-alpha-fa13546.0",
-    "@genesislcap/webpack-builder": "14.370.1-alpha-fa13546.0",
+    "@genesislcap/foundation-testing": "14.371.0-FUI-2456.1",
+    "@genesislcap/genx": "14.371.0-FUI-2456.1",
+    "@genesislcap/rollup-builder": "14.371.0-FUI-2456.1",
+    "@genesislcap/ts-builder": "14.371.0-FUI-2456.1",
+    "@genesislcap/uvu-playwright-builder": "14.371.0-FUI-2456.1",
+    "@genesislcap/vite-builder": "14.371.0-FUI-2456.1",
+    "@genesislcap/webpack-builder": "14.371.0-FUI-2456.1",
     "@types/json-schema": "^7.0.11"
   },
   "dependencies": {
-    "@genesislcap/expression-builder": "14.370.1-alpha-fa13546.0",
-    "@genesislcap/foundation-logger": "14.370.1-alpha-fa13546.0",
+    "@genesislcap/expression-builder": "14.371.0-FUI-2456.1",
+    "@genesislcap/foundation-logger": "14.371.0-FUI-2456.1",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",
     "@microsoft/fast-foundation": "2.49.6",
@@ -56,5 +56,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "563c0837d18d73bd4bad45e74e6809ab1922514c"
+  "gitHead": "c3c009d8ba522f9a7cc445c623973248e5e26cf2"
 }