@genesislcap/foundation-utils 14.371.0 → 14.373.0

package/dist/custom-elements.json

@@ -63,6 +63,14 @@
             "package": "./error"
           }
         },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./feature-flags"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -1268,6 +1276,54 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/feature-flags/featureFlags.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "isFeatureActivated",
+          "return": {
+            "type": {
+              "text": "boolean"
+            }
+          },
+          "parameters": [
+            {
+              "name": "feature",
+              "type": {
+                "text": "string"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "isFeatureActivated",
+          "declaration": {
+            "name": "isFeatureActivated",
+            "module": "src/feature-flags/featureFlags.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/feature-flags/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./featureFlags"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/formatters/datetime.ts",
@@ -3489,6 +3545,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 +3722,14 @@
       "path": "src/utils/index.ts",
       "declarations": [],
       "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./deepMerge"
+          }
+        },
         {
           "kind": "js",
           "name": "*",

package/dist/dts/env/variables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../../src/env/variables.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,QAAA,IAAI,QAAQ,EAAE,MAAkB,CAAC;AAQjC,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,CAAC;AAG/B;;;;;;;GAOG;AACH,QAAA,IAAI,YAAY,EAAE,MAAY,CAAC;AAS/B,OAAO,EAAE,YAAY,IAAI,WAAW,EAAE,CAAC;AAGvC;;;;;;;;GAQG;AACH,QAAA,IAAI,WAAW,EAAE,MAAc,CAAC;AAQhC,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,CAAC;AAGrC;;;;GAIG;AACH,QAAA,IAAI,WAAW,EAAE,MAAM,CAAC;AAMxB,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,CAAC;AAErC;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,QAAgG,CAAC;AAOhI;;;;;;GAMG;AACH,QAAA,IAAI,SAAS,EAAE,MAAwD,CAAC;AAQxE,OAAO,EAAE,SAAS,IAAI,QAAQ,EAAE,CAAC;AAGjC;;;;GAIG;AACH,QAAA,IAAI,YAAY,EAAE,MAAM,CAAC;AAMzB,OAAO,EAAE,YAAY,IAAI,WAAW,EAAE,CAAC;AAKvC;;;;GAIG;AACH,QAAA,IAAI,qBAAqB,EAAE,MAAM,CAAC;AAMlC,OAAO,EAAE,qBAAqB,IAAI,oBAAoB,EAAE,CAAC;AAGzD;;;;GAIG;AACH,QAAA,IAAI,iBAAiB,EAAE,MAAM,CAAC;AAM9B,OAAO,EAAE,iBAAiB,IAAI,gBAAgB,EAAE,CAAC;AAGjD;;;;GAIG;AACH,QAAA,IAAI,aAAa,EAAE,MAAM,CAAC;AAM1B,OAAO,EAAE,aAAa,IAAI,YAAY,EAAE,CAAC;AAGzC;;GAEG;AACH,QAAA,IAAI,SAAS,EAAE,MAA+B,CAAC;AAM/C,OAAO,EAAE,SAAS,EAAE,CAAC;AAGrB;;GAEG;AACH,QAAA,IAAI,iBAAiB,EAAE,MAA+B,CAAC;AAMvD,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B;;GAEG;AACH,QAAA,IAAI,iBAAiB,EAAE,MAAkC,CAAC;AAM1D,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B;;GAEG;AACH,QAAA,IAAI,UAAU,EAAE,MAA2B,CAAC;AAM5C,OAAO,EAAE,UAAU,EAAE,CAAC;AAGtB;;GAEG;AACH,QAAA,IAAI,mBAAmB,EAAE,MAAyC,CAAC;AAMnE,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAG/B;;GAEG;AACH,QAAA,IAAI,mBAAmB,EAAE,MAAgD,CAAC;AAM1E,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAG/B;;GAEG;AACH,QAAA,IAAI,kBAAkB,EAAE,MAA0C,CAAC;AAMnE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAG9B;;GAEG;AACH,QAAA,IAAI,YAAY,EAAE,MAAuB,CAAC;AAM1C,OAAO,EAAE,YAAY,EAAE,CAAC;AAGxB;;GAEG;AACH,QAAA,IAAI,aAAa,EAAE,MAAoC,CAAC;AAMxD,OAAO,EAAE,aAAa,EAAE,CAAC;AAGzB;;GAEG;AACH,QAAA,IAAI,iBAAiB,EAAE,MAAkB,CAAC;AAM1C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B;;GAEG;AACH,QAAA,IAAI,gBAAgB,EAAE,MAAgC,CAAC;AAMvD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../../../src/env/variables.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,QAAA,IAAI,QAAQ,EAAE,MAAkB,CAAC;AAQjC,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,CAAC;AAG/B;;;;;;;GAOG;AACH,QAAA,IAAI,YAAY,EAAE,MAAY,CAAC;AAS/B,OAAO,EAAE,YAAY,IAAI,WAAW,EAAE,CAAC;AAGvC;;;;;;;;GAQG;AACH,QAAA,IAAI,WAAW,EAAE,MAAc,CAAC;AAQhC,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,CAAC;AAGrC;;;;GAIG;AACH,QAAA,IAAI,WAAW,EAAE,MAAM,CAAC;AAMxB,OAAO,EAAE,WAAW,IAAI,UAAU,EAAE,CAAC;AAErC;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,QAAgG,CAAC;AAShI;;;;;;GAMG;AACH,QAAA,IAAI,SAAS,EAAE,MAAwD,CAAC;AAQxE,OAAO,EAAE,SAAS,IAAI,QAAQ,EAAE,CAAC;AAGjC;;;;GAIG;AACH,QAAA,IAAI,YAAY,EAAE,MAAM,CAAC;AAMzB,OAAO,EAAE,YAAY,IAAI,WAAW,EAAE,CAAC;AAKvC;;;;GAIG;AACH,QAAA,IAAI,qBAAqB,EAAE,MAAM,CAAC;AAMlC,OAAO,EAAE,qBAAqB,IAAI,oBAAoB,EAAE,CAAC;AAGzD;;;;GAIG;AACH,QAAA,IAAI,iBAAiB,EAAE,MAAM,CAAC;AAM9B,OAAO,EAAE,iBAAiB,IAAI,gBAAgB,EAAE,CAAC;AAGjD;;;;GAIG;AACH,QAAA,IAAI,aAAa,EAAE,MAAM,CAAC;AAM1B,OAAO,EAAE,aAAa,IAAI,YAAY,EAAE,CAAC;AAGzC;;GAEG;AACH,QAAA,IAAI,SAAS,EAAE,MAA+B,CAAC;AAM/C,OAAO,EAAE,SAAS,EAAE,CAAC;AAGrB;;GAEG;AACH,QAAA,IAAI,iBAAiB,EAAE,MAA+B,CAAC;AAMvD,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B;;GAEG;AACH,QAAA,IAAI,iBAAiB,EAAE,MAAkC,CAAC;AAM1D,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B;;GAEG;AACH,QAAA,IAAI,UAAU,EAAE,MAA2B,CAAC;AAM5C,OAAO,EAAE,UAAU,EAAE,CAAC;AAGtB;;GAEG;AACH,QAAA,IAAI,mBAAmB,EAAE,MAAyC,CAAC;AAMnE,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAG/B;;GAEG;AACH,QAAA,IAAI,mBAAmB,EAAE,MAAgD,CAAC;AAM1E,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAG/B;;GAEG;AACH,QAAA,IAAI,kBAAkB,EAAE,MAA0C,CAAC;AAMnE,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAG9B;;GAEG;AACH,QAAA,IAAI,YAAY,EAAE,MAAuB,CAAC;AAM1C,OAAO,EAAE,YAAY,EAAE,CAAC;AAGxB;;GAEG;AACH,QAAA,IAAI,aAAa,EAAE,MAAoC,CAAC;AAMxD,OAAO,EAAE,aAAa,EAAE,CAAC;AAGzB;;GAEG;AACH,QAAA,IAAI,iBAAiB,EAAE,MAAkB,CAAC;AAM1C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAG7B;;GAEG;AACH,QAAA,IAAI,gBAAgB,EAAE,MAAgC,CAAC;AAMvD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/dts/feature-flags/featureFlags.d.ts

@@ -0,0 +1,2 @@
+export declare const isFeatureActivated: (feature: string) => boolean;
+//# sourceMappingURL=featureFlags.d.ts.map

package/dist/dts/feature-flags/featureFlags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureFlags.d.ts","sourceRoot":"","sources":["../../../src/feature-flags/featureFlags.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,KAAG,OAapD,CAAC"}

package/dist/dts/feature-flags/index.d.ts

@@ -0,0 +1,2 @@
+export * from './featureFlags';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/feature-flags/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/feature-flags/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/dts/index.d.ts

@@ -5,6 +5,7 @@ export * from './directives';
 export * from './encoding';
 export * from './env';
 export * from './error';
+export * from './feature-flags';
 export * from './formatters';
 export * from './logger';
 export * from './mappers';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}

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/env/variables.js

@@ -1,4 +1,5 @@
 /* eslint-disable import/no-mutable-exports */
+import { isFeatureActivated } from '../feature-flags';
 /**
  * The builder aka file bundler.
  * @privateRemarks
@@ -71,7 +72,9 @@ export { _FORCE_HTTP as FORCE_HTTP };
  * @public
  */
 export const GENESIS_SOCKET_URL = `${location.protocol.replace('http', 'ws')}//${location.host}${_PUBLIC_PATH}/${_SOCKET_EXT}/`;
-const PROTOCOL = _FORCE_HTTP === 'true' ? location.protocol : location.protocol.replace('http', 'ws');
+const PROTOCOL = _FORCE_HTTP === 'true' || isFeatureActivated('forceHttp')
+    ? location.protocol
+    : location.protocol.replace('http', 'ws');
 /**
  * The Genesis Server URL (WebSocket or HTTP).
  * @remarks Optional.

package/dist/esm/feature-flags/featureFlags.js

@@ -0,0 +1,12 @@
+export const isFeatureActivated = (feature) => {
+    const currentUrl = window.location.href;
+    const queryString = new URL(currentUrl).search;
+    const params = new URLSearchParams(queryString);
+    const featureKey = `feature.${feature}`.toLowerCase();
+    for (const [key] of params.entries()) {
+        if (key.toLowerCase() === featureKey) {
+            return true;
+        }
+    }
+    return false;
+};

package/dist/esm/feature-flags/index.js

@@ -0,0 +1 @@
+export * from './featureFlags';

package/dist/esm/index.js

@@ -5,6 +5,7 @@ export * from './directives';
 export * from './encoding';
 export * from './env';
 export * from './error';
+export * from './feature-flags';
 export * from './formatters';
 export * from './logger';
 export * from './mappers';

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",
@@ -7456,6 +7544,47 @@
           "parameters": [],
           "name": "isDev"
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-utils!isFeatureActivated:function(1)",
+          "docComment": "",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "isFeatureActivated: (feature: "
+            },
+            {
+              "kind": "Content",
+              "text": "string"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Content",
+              "text": "boolean"
+            }
+          ],
+          "fileUrlPath": "src/feature-flags/featureFlags.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 3,
+            "endIndex": 4
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "feature",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            }
+          ],
+          "name": "isFeatureActivated"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-utils!JSONReplacer:function(1)",

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.
@@ -820,6 +838,8 @@ export declare const inSymphonyDesktop: () => boolean;
  */
 export declare const isDev: () => boolean;
 
+export declare const isFeatureActivated: (feature: string) => boolean;
+
 /**
  * JSON replacer function.
  * @param key - The object key.

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.isfeatureactivated.md

@@ -0,0 +1,50 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@genesislcap/foundation-utils](./foundation-utils.md) &gt; [isFeatureActivated](./foundation-utils.isfeatureactivated.md)
+
+## isFeatureActivated() function
+
+**Signature:**
+
+```typescript
+isFeatureActivated: (feature: string) => boolean
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+feature
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+boolean
+

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>
 
@@ -454,6 +465,15 @@ Returns a boolean value indicating whether the user is running the Symphony desk
 Determines if the current environment is a development environment.
 
 
+</td></tr>
+<tr><td>
+
+[isFeatureActivated(feature)](./foundation-utils.isfeatureactivated.md)
+
+
+</td><td>
+
+
 </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;
 
@@ -517,6 +520,9 @@ export const inSymphonyDesktop: () => boolean;
 // @public
 export const isDev: () => boolean;
 
+// @public (undocumented)
+export const isFeatureActivated: (feature: string) => boolean;
+
 // @public
 export function JSONReplacer(key: string, value: any): any;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.371.0",
+  "version": "14.373.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -27,18 +27,18 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.371.0",
-    "@genesislcap/genx": "14.371.0",
-    "@genesislcap/rollup-builder": "14.371.0",
-    "@genesislcap/ts-builder": "14.371.0",
-    "@genesislcap/uvu-playwright-builder": "14.371.0",
-    "@genesislcap/vite-builder": "14.371.0",
-    "@genesislcap/webpack-builder": "14.371.0",
+    "@genesislcap/foundation-testing": "14.373.0",
+    "@genesislcap/genx": "14.373.0",
+    "@genesislcap/rollup-builder": "14.373.0",
+    "@genesislcap/ts-builder": "14.373.0",
+    "@genesislcap/uvu-playwright-builder": "14.373.0",
+    "@genesislcap/vite-builder": "14.373.0",
+    "@genesislcap/webpack-builder": "14.373.0",
     "@types/json-schema": "^7.0.11"
   },
   "dependencies": {
-    "@genesislcap/expression-builder": "14.371.0",
-    "@genesislcap/foundation-logger": "14.371.0",
+    "@genesislcap/expression-builder": "14.373.0",
+    "@genesislcap/foundation-logger": "14.373.0",
     "@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": "ea4401059f690d90b8c5ebbfdd0c9bea654fa611"
+  "gitHead": "134490c6c8be9d443484692e1769bda61b00fa1e"
 }