@genesislcap/foundation-utils 14.497.0 → 14.499.0

package/dist/custom-elements.json

@@ -452,6 +452,44 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/encoding/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./base64"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./sync"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./when-else"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/data/inMemoryDatabase.ts",
@@ -650,97 +688,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./sync"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./when-else"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/decorators/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./renderOnChange"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/decorators/renderOnChange.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "renderOnChange",
-          "parameters": [
-            {
-              "name": "target",
-              "type": {
-                "text": "FASTElement & { render(): void }"
-              },
-              "description": "The target to define the property change handler on."
-            },
-            {
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "description": "The property name."
-            }
-          ],
-          "description": "Defines a property changed handler that calls a render() method on the target as an internal observation enhancement.",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "renderOnChange",
-          "declaration": {
-            "name": "renderOnChange",
-            "module": "src/decorators/renderOnChange.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/encoding/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./base64"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/env/index.ts",
@@ -1216,6 +1163,59 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/decorators/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./renderOnChange"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/decorators/renderOnChange.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "renderOnChange",
+          "parameters": [
+            {
+              "name": "target",
+              "type": {
+                "text": "FASTElement & { render(): void }"
+              },
+              "description": "The target to define the property change handler on."
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "description": "The property name."
+            }
+          ],
+          "description": "Defines a property changed handler that calls a render() method on the target as an internal observation enhancement.",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "renderOnChange",
+          "declaration": {
+            "name": "renderOnChange",
+            "module": "src/decorators/renderOnChange.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/error/errorMap.ts",
@@ -1434,7 +1434,46 @@
                 "text": "string"
               }
             }
-          ]
+          ],
+          "description": "Returns true when `feature.<name>` is present in the current URL query string.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "getActivatedFeatures",
+          "return": {
+            "type": {
+              "text": "string[]"
+            }
+          },
+          "description": "Returns the names of all feature flags currently present in the URL query string.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "setActivatedFeatures",
+          "return": {
+            "type": {
+              "text": "void"
+            }
+          },
+          "parameters": [
+            {
+              "name": "features",
+              "type": {
+                "text": "string[]"
+              }
+            },
+            {
+              "name": "options",
+              "default": "{}",
+              "type": {
+                "text": "SetActivatedFeaturesOptions"
+              }
+            }
+          ],
+          "description": "Rewrites URL `feature.*` query params to match the given feature list (presence-only).\nRemoves any existing `feature.*` params, then adds each selected feature as `feature.<name>`.\nReloads by default so boot-time consumers (e.g. AI registration) pick up the change.",
+          "privacy": "public"
         }
       ],
       "exports": [
@@ -1445,6 +1484,22 @@
             "name": "isFeatureActivated",
             "module": "src/feature-flags/featureFlags.ts"
           }
+        },
+        {
+          "kind": "js",
+          "name": "getActivatedFeatures",
+          "declaration": {
+            "name": "getActivatedFeatures",
+            "module": "src/feature-flags/featureFlags.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "setActivatedFeatures",
+          "declaration": {
+            "name": "setActivatedFeatures",
+            "module": "src/feature-flags/featureFlags.ts"
+          }
         }
       ]
     },
@@ -4825,168 +4880,14 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/directives/sync/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./sync"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/sync/sync.ts",
+      "path": "src/encoding/base64/decode.ts",
       "declarations": [
-        {
-          "kind": "variable",
-          "name": "defaultEventMap",
-          "type": {
-            "text": "Map<string, EventName>"
-          },
-          "default": "new Map([\n  ['FAST-TEXT-AREA', 'input'],\n  ['FAST-TEXT-FIELD', 'input'],\n  ['FOUNDATION-TEXT-AREA', 'input'],\n  ['FOUNDATION-TEXT-FIELD', 'input'],\n  ['INPUT', 'input'],\n  ['ZERO-TEXT-FIELD', 'input'],\n])",
-          "description": "A map that associates specific HTML element tags with their corresponding default event names.",
-          "privacy": "public"
-        },
         {
           "kind": "function",
-          "name": "sync",
+          "name": "decodeFromBase64",
           "return": {
             "type": {
-              "text": "CaptureType<TSource>"
-            }
-          },
-          "parameters": [
-            {
-              "name": "binding",
-              "type": {
-                "text": "Binding<TSource, TReturn>"
-              }
-            },
-            {
-              "name": "conversionType",
-              "default": "'string'",
-              "type": {
-                "text": "ConversionType"
-              }
-            },
-            {
-              "name": "eventName",
-              "default": "'default'",
-              "type": {
-                "text": "EventName"
-              }
-            },
-            {
-              "name": "keyAttr",
-              "optional": true,
-              "type": {
-                "text": "string"
-              }
-            }
-          ],
-          "description": "Creates a synchronization directive that binds a data source to an HTML element,",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "defaultEventMap",
-          "declaration": {
-            "name": "defaultEventMap",
-            "module": "src/directives/sync/sync.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "sync",
-          "declaration": {
-            "name": "sync",
-            "module": "src/directives/sync/sync.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/when-else/index.ts",
-      "declarations": [],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "*",
-          "declaration": {
-            "name": "*",
-            "package": "./when-else"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/directives/when-else/when-else.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "whenElse",
-          "return": {
-            "type": {
-              "text": "CaptureType<TSource>"
-            }
-          },
-          "parameters": [
-            {
-              "name": "binding",
-              "type": {
-                "text": "Binding<TSource, TReturn>"
-              },
-              "description": "The condition to test for rendering."
-            },
-            {
-              "name": "trueTemplateOrTemplateBinding",
-              "type": {
-                "text": "WhenTemplate<TSource>"
-              },
-              "description": "The template or a binding that gets the template to render when the condition is true."
-            },
-            {
-              "name": "falseTemplateOrTemplateBinding",
-              "type": {
-                "text": "WhenTemplate<TSource>"
-              },
-              "description": "The template or a binding that gets the template to render when the condition is false."
-            }
-          ],
-          "description": "Directive that allows supplying an \"else\" template to the traditional https://www.fast.design/docs/api/fast-element.when/#when-function directive",
-          "privacy": "public"
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "whenElse",
-          "declaration": {
-            "name": "whenElse",
-            "module": "src/directives/when-else/when-else.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/encoding/base64/decode.ts",
-      "declarations": [
-        {
-          "kind": "function",
-          "name": "decodeFromBase64",
-          "return": {
-            "type": {
-              "text": ""
+              "text": ""
             }
           },
           "parameters": [
@@ -5131,6 +5032,160 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/sync/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./sync"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/sync/sync.ts",
+      "declarations": [
+        {
+          "kind": "variable",
+          "name": "defaultEventMap",
+          "type": {
+            "text": "Map<string, EventName>"
+          },
+          "default": "new Map([\n  ['FAST-TEXT-AREA', 'input'],\n  ['FAST-TEXT-FIELD', 'input'],\n  ['FOUNDATION-TEXT-AREA', 'input'],\n  ['FOUNDATION-TEXT-FIELD', 'input'],\n  ['INPUT', 'input'],\n  ['ZERO-TEXT-FIELD', 'input'],\n])",
+          "description": "A map that associates specific HTML element tags with their corresponding default event names.",
+          "privacy": "public"
+        },
+        {
+          "kind": "function",
+          "name": "sync",
+          "return": {
+            "type": {
+              "text": "CaptureType<TSource>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "binding",
+              "type": {
+                "text": "Binding<TSource, TReturn>"
+              }
+            },
+            {
+              "name": "conversionType",
+              "default": "'string'",
+              "type": {
+                "text": "ConversionType"
+              }
+            },
+            {
+              "name": "eventName",
+              "default": "'default'",
+              "type": {
+                "text": "EventName"
+              }
+            },
+            {
+              "name": "keyAttr",
+              "optional": true,
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Creates a synchronization directive that binds a data source to an HTML element,",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "defaultEventMap",
+          "declaration": {
+            "name": "defaultEventMap",
+            "module": "src/directives/sync/sync.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "sync",
+          "declaration": {
+            "name": "sync",
+            "module": "src/directives/sync/sync.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/when-else/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./when-else"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/directives/when-else/when-else.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "whenElse",
+          "return": {
+            "type": {
+              "text": "CaptureType<TSource>"
+            }
+          },
+          "parameters": [
+            {
+              "name": "binding",
+              "type": {
+                "text": "Binding<TSource, TReturn>"
+              },
+              "description": "The condition to test for rendering."
+            },
+            {
+              "name": "trueTemplateOrTemplateBinding",
+              "type": {
+                "text": "WhenTemplate<TSource>"
+              },
+              "description": "The template or a binding that gets the template to render when the condition is true."
+            },
+            {
+              "name": "falseTemplateOrTemplateBinding",
+              "type": {
+                "text": "WhenTemplate<TSource>"
+              },
+              "description": "The template or a binding that gets the template to render when the condition is false."
+            }
+          ],
+          "description": "Directive that allows supplying an \"else\" template to the traditional https://www.fast.design/docs/api/fast-element.when/#when-function directive",
+          "privacy": "public"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "whenElse",
+          "declaration": {
+            "name": "whenElse",
+            "module": "src/directives/when-else/when-else.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/mappers/dto/index.ts",

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

@@ -1,2 +1,47 @@
+/**
+ * Options for {@link setActivatedFeatures}.
+ * @public
+ */
+export type SetActivatedFeaturesOptions = {
+    /**
+     * When true (default), navigates to the updated URL so boot-time consumers re-evaluate.
+     * When false, updates the URL via `history.replaceState` without reloading.
+     */
+    reload?: boolean;
+};
+/**
+ * Returns true when `feature.<name>` is present in the given search string.
+ * @internal
+ */
+export declare const isFeatureActivatedInSearch: (search: string, feature: string) => boolean;
+/**
+ * Returns the names of all feature flags present in the given search string.
+ * @internal
+ */
+export declare const getActivatedFeaturesFromSearch: (search: string) => string[];
+/**
+ * Returns a new URL with `feature.*` query params rewritten to match the given feature list.
+ * @internal
+ */
+export declare const applyActivatedFeaturesToUrl: (url: URL, features: string[]) => URL;
+/**
+ * Returns true when `feature.<name>` is present in the current URL query string.
+ * @public
+ */
 export declare const isFeatureActivated: (feature: string) => boolean;
+/**
+ * Returns the names of all feature flags currently present in the URL query string.
+ * @example
+ * // URL: ?feature.ai&feature.forceHttp=true
+ * getActivatedFeatures(); // ['ai', 'forceHttp']
+ * @public
+ */
+export declare const getActivatedFeatures: () => string[];
+/**
+ * Rewrites URL `feature.*` query params to match the given feature list (presence-only).
+ * Removes any existing `feature.*` params, then adds each selected feature as `feature.<name>`.
+ * Reloads by default so boot-time consumers (e.g. AI registration) pick up the change.
+ * @public
+ */
+export declare const setActivatedFeatures: (features: string[], options?: SetActivatedFeaturesOptions) => void;
 //# sourceMappingURL=featureFlags.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"featureFlags.d.ts","sourceRoot":"","sources":["../../../src/feature-flags/featureFlags.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,MAAM,EAAE,SAAS,MAAM,KAAG,OAe5E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GAAI,QAAQ,MAAM,KAAG,MAAM,EAcrE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,GAAI,KAAK,GAAG,EAAE,UAAU,MAAM,EAAE,KAAG,GAmB1E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,KAAG,OACQ,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAAO,MAAM,EACU,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,EAAE,EAClB,UAAS,2BAAgC,KACxC,IAUF,CAAC"}

package/dist/dts/mixins/lifecycle/lifecycle.d.ts

@@ -70,6 +70,15 @@ export declare const LifecycleMixin: <T extends ConstructableLifecycleHandler>(B
          * @internal
          **/
         #_shouldForceLifecycle: boolean;
+        /**
+         * Set once a short grace period (`setTimeout`) has elapsed since a blocked ('reflow')
+         * disconnect. Some consumers run defensive cleanup after the block via schedulers that can
+         * outlast a microtask (e.g. FAST's `DOM.queueUpdate`), so a macrotask-scale grace period is
+         * needed - once it has passed, the paired reconnect must not stay blocked, or the consumer
+         * never re-initializes.
+         * @internal
+         **/
+        #_blockedDisconnectSurvivedGracePeriod: boolean;
         /**
          * @privateRemarks
          * Rather than using the basic implementation of cloning we run a copy constructor (deepClone)

package/dist/dts/mixins/lifecycle/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/mixins/lifecycle/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC;AAErF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,yBAAyB,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,KAAK,CAAC;CACb,CAAC;AAEF,KAAK,SAAS,GAAG,yBAAyB,GAAG,oBAAoB,GAAG,YAAY,CAAC;AAEjF,KAAK,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;AAK5D;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,6BAA6B,EAAE,MAAM,CAAC;kBA+BtD,GAAG,EAAE;QA7B1B,iBAAiB;qBACJ,SAAS;QAEtB;;;YAGI;2BACe,MAAM;QACzB;;;YAGI;0BACc,OAAO;QACzB;;;;;;;YAOI;0BACc,MAAM,CAAC,OAAO;QAChC;;;;YAII;gCACoB,OAAO;QAM/B;;;;;WAKG;yBACuB,OAAO,GAAG,IAAI;QAUxC;;;;;;WAMG;qBACU,IAAI;QAMjB;;;WAGG;;QAmBH;;;;;WAKG;;wDAwB6C,aAAa,GAAG,OAAO;QAkCvE;;;;;;WAMG;qCAC0B,OAAO,GAAG,SAAS;6BA4B3B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAM1B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,mBAAmB,eAAkC,CAAC"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/mixins/lifecycle/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,aAAa,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC;AAErF;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,mBAAmB,CAAC;CAC3B,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,yBAAyB,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,KAAK,CAAC;CACb,CAAC;AAEF,KAAK,SAAS,GAAG,yBAAyB,GAAG,oBAAoB,GAAG,YAAY,CAAC;AAEjF,KAAK,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;AAK5D;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,6BAA6B,EAAE,MAAM,CAAC;kBAwCtD,GAAG,EAAE;QAtC1B,iBAAiB;qBACJ,SAAS;QAEtB;;;YAGI;2BACe,MAAM;QACzB;;;YAGI;0BACc,OAAO;QACzB;;;;;;;YAOI;0BACc,MAAM,CAAC,OAAO;QAChC;;;;YAII;gCACoB,OAAO;QAC/B;;;;;;;YAOI;gDACoC,OAAO;QAM/C;;;;;WAKG;yBACuB,OAAO,GAAG,IAAI;QAUxC;;;;;;WAMG;qBACU,IAAI;QAMjB;;;WAGG;;QAmBH;;;;;WAKG;;wDAwB6C,aAAa,GAAG,OAAO;QAyCvE;;;;;;WAMG;qCAC0B,OAAO,GAAG,SAAS;6BA4B3B,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAM1B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,mBAAmB,eAAkC,CAAC"}

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

@@ -1,8 +1,15 @@
-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();
+const FEATURE_PREFIX = 'feature.';
+const isFeatureParamKey = (key) => key.toLowerCase().startsWith(FEATURE_PREFIX);
+/**
+ * Returns true when `feature.<name>` is present in the given search string.
+ * @internal
+ */
+export const isFeatureActivatedInSearch = (search, feature) => {
+    if (!feature) {
+        return false;
+    }
+    const featureKey = `${FEATURE_PREFIX}${feature}`.toLowerCase();
+    const params = new URLSearchParams(search);
     for (const [key] of params.entries()) {
         if (key.toLowerCase() === featureKey) {
             return true;
@@ -10,3 +17,69 @@ export const isFeatureActivated = (feature) => {
     }
     return false;
 };
+/**
+ * Returns the names of all feature flags present in the given search string.
+ * @internal
+ */
+export const getActivatedFeaturesFromSearch = (search) => {
+    const params = new URLSearchParams(search);
+    const features = [];
+    for (const [key] of params.entries()) {
+        if (isFeatureParamKey(key)) {
+            const feature = key.slice(FEATURE_PREFIX.length);
+            if (feature) {
+                features.push(feature);
+            }
+        }
+    }
+    return features;
+};
+/**
+ * Returns a new URL with `feature.*` query params rewritten to match the given feature list.
+ * @internal
+ */
+export const applyActivatedFeaturesToUrl = (url, features) => {
+    const next = new URL(url.href);
+    const params = next.searchParams;
+    for (const key of [...params.keys()]) {
+        if (isFeatureParamKey(key)) {
+            params.delete(key);
+        }
+    }
+    for (const feature of features) {
+        if (feature) {
+            // Use an explicit value so routers/normalizers that drop empty query values
+            // (e.g. some React Router redirect paths) still preserve the flag.
+            params.set(`${FEATURE_PREFIX}${feature}`, 'true');
+        }
+    }
+    return next;
+};
+/**
+ * Returns true when `feature.<name>` is present in the current URL query string.
+ * @public
+ */
+export const isFeatureActivated = (feature) => isFeatureActivatedInSearch(window.location.search, feature);
+/**
+ * Returns the names of all feature flags currently present in the URL query string.
+ * @example
+ * // URL: ?feature.ai&feature.forceHttp=true
+ * getActivatedFeatures(); // ['ai', 'forceHttp']
+ * @public
+ */
+export const getActivatedFeatures = () => getActivatedFeaturesFromSearch(window.location.search);
+/**
+ * Rewrites URL `feature.*` query params to match the given feature list (presence-only).
+ * Removes any existing `feature.*` params, then adds each selected feature as `feature.<name>`.
+ * Reloads by default so boot-time consumers (e.g. AI registration) pick up the change.
+ * @public
+ */
+export const setActivatedFeatures = (features, options = {}) => {
+    const { reload = true } = options;
+    const url = applyActivatedFeaturesToUrl(new URL(window.location.href), features);
+    if (reload) {
+        window.location.assign(url.toString());
+        return;
+    }
+    window.history.replaceState({}, '', url.toString());
+};

package/dist/esm/mixins/lifecycle/lifecycle.js

@@ -11,7 +11,7 @@ const CLEANUP_TIMEOUT_MS = 10000;
  * #_ syntax is used for a javascript private method/variable
  * we can't use private/protected from typescript in an anonymous class like this
  */
-export const LifecycleMixin = (Base) => { var _instances, __container, __latestTokenCode, __hasFirstLoaded, __cleanupTimeout, __shouldForceLifecycle, __blockLifecycleDueToTokenChange, __tryFindContainingLayout, _a; return _a = class extends Base {
+export const LifecycleMixin = (Base) => { var _instances, __container, __latestTokenCode, __hasFirstLoaded, __cleanupTimeout, __shouldForceLifecycle, __blockedDisconnectSurvivedGracePeriod, __blockLifecycleDueToTokenChange, __tryFindContainingLayout, _a; return _a = class extends Base {
         constructor(...args) {
             super(args);
             _instances.add(this);
@@ -42,6 +42,15 @@ export const LifecycleMixin = (Base) => { var _instances, __container, __latestT
              * @internal
              **/
             __shouldForceLifecycle.set(this, false);
+            /**
+             * Set once a short grace period (`setTimeout`) has elapsed since a blocked ('reflow')
+             * disconnect. Some consumers run defensive cleanup after the block via schedulers that can
+             * outlast a microtask (e.g. FAST's `DOM.queueUpdate`), so a macrotask-scale grace period is
+             * needed - once it has passed, the paired reconnect must not stay blocked, or the consumer
+             * never re-initializes.
+             * @internal
+             **/
+            __blockedDisconnectSurvivedGracePeriod.set(this, false);
         }
         /**
          * @privateRemarks
@@ -127,6 +136,7 @@ export const LifecycleMixin = (Base) => { var _instances, __container, __latestT
     __hasFirstLoaded = new WeakMap(),
     __cleanupTimeout = new WeakMap(),
     __shouldForceLifecycle = new WeakMap(),
+    __blockedDisconnectSurvivedGracePeriod = new WeakMap(),
     _instances = new WeakSet(),
     __blockLifecycleDueToTokenChange = function __blockLifecycleDueToTokenChange(lifecycleType) {
         var _b, _c;
@@ -146,6 +156,14 @@ export const LifecycleMixin = (Base) => { var _instances, __container, __latestT
                 // 'reconnect' - otherwise unrelated layout changes while disconnected can block it forever.
                 __classPrivateFieldSet(this, __hasFirstLoaded, false, "f");
             }
+            else {
+                // Blocked disconnect: track whether a grace period elapses before the paired reconnect
+                // arrives. See `#_blockedDisconnectSurvivedGracePeriod` for why this matters.
+                __classPrivateFieldSet(this, __blockedDisconnectSurvivedGracePeriod, false, "f");
+                setTimeout(() => {
+                    __classPrivateFieldSet(this, __blockedDisconnectSurvivedGracePeriod, true, "f");
+                }, 0);
+            }
             __classPrivateFieldSet(this, __cleanupTimeout, setTimeout(() => {
                 __classPrivateFieldSet(this, __shouldForceLifecycle, result, "f");
                 if (__classPrivateFieldGet(this, __shouldForceLifecycle, "f")) {
@@ -154,7 +172,7 @@ export const LifecycleMixin = (Base) => { var _instances, __container, __latestT
             }, CLEANUP_TIMEOUT_MS), "f");
         }
         else if (lifecycleType === 'reconnect') {
-            result = tokensDifferent;
+            result = tokensDifferent && !__classPrivateFieldGet(this, __blockedDisconnectSurvivedGracePeriod, "f");
             __classPrivateFieldSet(this, __latestTokenCode, (_c = __classPrivateFieldGet(this, __container, "f").lifecycleUpdateToken) !== null && _c !== void 0 ? _c : '', "f");
             clearTimeout(__classPrivateFieldGet(this, __cleanupTimeout, "f"));
         }

package/dist/foundation-utils.api.json

@@ -5829,6 +5829,30 @@
             }
           ]
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-utils!getActivatedFeatures:function(1)",
+          "docComment": "/**\n * Returns the names of all feature flags currently present in the URL query string.\n *\n * @example\n *\n * // URL: ?feature.ai&feature.forceHttp=true getActivatedFeatures(); // ['ai', 'forceHttp']\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "getActivatedFeatures: () => "
+            },
+            {
+              "kind": "Content",
+              "text": "string[]"
+            }
+          ],
+          "fileUrlPath": "src/feature-flags/featureFlags.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [],
+          "name": "getActivatedFeatures"
+        },
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-utils!getAllElements:function(1)",
@@ -8246,7 +8270,7 @@
         {
           "kind": "Function",
           "canonicalReference": "@genesislcap/foundation-utils!isFeatureActivated:function(1)",
-          "docComment": "",
+          "docComment": "/**\n * Returns true when `feature.<name>` is present in the current URL query string.\n *\n * @public\n */\n",
           "excerptTokens": [
             {
               "kind": "Content",
@@ -9094,7 +9118,7 @@
             },
             {
               "kind": "Content",
-              "text": ";\n        #_shouldForceLifecycle: boolean;\n        cloneNode(deep?: boolean): "
+              "text": ";\n        #_shouldForceLifecycle: boolean;\n        #_blockedDisconnectSurvivedGracePeriod: boolean;\n        cloneNode(deep?: boolean): "
             },
             {
               "kind": "Reference",
@@ -17879,6 +17903,90 @@
             "endIndex": 4
           }
         },
+        {
+          "kind": "Function",
+          "canonicalReference": "@genesislcap/foundation-utils!setActivatedFeatures:function(1)",
+          "docComment": "/**\n * Rewrites URL `feature.*` query params to match the given feature list (presence-only). Removes any existing `feature.*` params, then adds each selected feature as `feature.<name>`. Reloads by default so boot-time consumers (e.g. AI registration) pick up the change.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "setActivatedFeatures: (features: "
+            },
+            {
+              "kind": "Content",
+              "text": "string[]"
+            },
+            {
+              "kind": "Content",
+              "text": ", options?: "
+            },
+            {
+              "kind": "Reference",
+              "text": "SetActivatedFeaturesOptions",
+              "canonicalReference": "@genesislcap/foundation-utils!SetActivatedFeaturesOptions:type"
+            },
+            {
+              "kind": "Content",
+              "text": ") => "
+            },
+            {
+              "kind": "Content",
+              "text": "void"
+            }
+          ],
+          "fileUrlPath": "src/feature-flags/featureFlags.ts",
+          "returnTypeTokenRange": {
+            "startIndex": 5,
+            "endIndex": 6
+          },
+          "releaseTag": "Public",
+          "overloadIndex": 1,
+          "parameters": [
+            {
+              "parameterName": "features",
+              "parameterTypeTokenRange": {
+                "startIndex": 1,
+                "endIndex": 2
+              },
+              "isOptional": false
+            },
+            {
+              "parameterName": "options",
+              "parameterTypeTokenRange": {
+                "startIndex": 3,
+                "endIndex": 4
+              },
+              "isOptional": true
+            }
+          ],
+          "name": "setActivatedFeatures"
+        },
+        {
+          "kind": "TypeAlias",
+          "canonicalReference": "@genesislcap/foundation-utils!SetActivatedFeaturesOptions:type",
+          "docComment": "/**\n * Options for {@link setActivatedFeatures}.\n *\n * @public\n */\n",
+          "excerptTokens": [
+            {
+              "kind": "Content",
+              "text": "export type SetActivatedFeaturesOptions = "
+            },
+            {
+              "kind": "Content",
+              "text": "{\n    reload?: boolean;\n}"
+            },
+            {
+              "kind": "Content",
+              "text": ";"
+            }
+          ],
+          "fileUrlPath": "src/feature-flags/featureFlags.ts",
+          "releaseTag": "Public",
+          "name": "SetActivatedFeaturesOptions",
+          "typeTokenRange": {
+            "startIndex": 1,
+            "endIndex": 2
+          }
+        },
         {
           "kind": "Variable",
           "canonicalReference": "@genesislcap/foundation-utils!SHORTCUT_BLOCKED_DEFAULT_MESSAGE:var",

package/dist/foundation-utils.d.ts

@@ -38,6 +38,12 @@ export declare const activeColorScheme: CSSDesignToken<string>;
  */
 export declare let API_HOST: string;
 
+/**
+ * Returns a new URL with `feature.*` query params rewritten to match the given feature list.
+ * @internal
+ */
+export declare const applyActivatedFeaturesToUrl: (url: URL, features: string[]) => URL;
+
 /**
  * assureDesignSystem.
  *
@@ -682,6 +688,21 @@ export declare namespace Genesis {
  */
 export declare const GENESIS_SOCKET_URL: string;
 
+/**
+ * Returns the names of all feature flags currently present in the URL query string.
+ * @example
+ * // URL: ?feature.ai&feature.forceHttp=true
+ * getActivatedFeatures(); // ['ai', 'forceHttp']
+ * @public
+ */
+export declare const getActivatedFeatures: () => string[];
+
+/**
+ * Returns the names of all feature flags present in the given search string.
+ * @internal
+ */
+export declare const getActivatedFeaturesFromSearch: (search: string) => string[];
+
 /**
  * Recursively gather all elements including those in shadow DOM
  * @public
@@ -890,8 +911,18 @@ export declare const inSymphonyDesktop: () => boolean;
  */
 export declare const isDev: () => boolean;
 
+/**
+ * Returns true when `feature.<name>` is present in the current URL query string.
+ * @public
+ */
 export declare const isFeatureActivated: (feature: string) => boolean;
 
+/**
+ * Returns true when `feature.<name>` is present in the given search string.
+ * @internal
+ */
+export declare const isFeatureActivatedInSearch: (search: string, feature: string) => boolean;
+
 /**
  * JSON replacer function.
  * @param key - The object key.
@@ -1018,6 +1049,15 @@ export declare const LifecycleMixin: <T extends ConstructableLifecycleHandler>(B
          * @internal
          **/
         #_shouldForceLifecycle: boolean;
+        /**
+         * Set once a short grace period (`setTimeout`) has elapsed since a blocked ('reflow')
+         * disconnect. Some consumers run defensive cleanup after the block via schedulers that can
+         * outlast a microtask (e.g. FAST's `DOM.queueUpdate`), so a macrotask-scale grace period is
+         * needed - once it has passed, the paired reconnect must not stay blocked, or the consumer
+         * never re-initializes.
+         * @internal
+         **/
+        #_blockedDisconnectSurvivedGracePeriod: boolean;
         /**
          * @privateRemarks
          * Rather than using the basic implementation of cloning we run a copy constructor (deepClone)
@@ -2264,6 +2304,26 @@ export declare type ServerRowEntity = {
     };
 };
 
+/**
+ * Rewrites URL `feature.*` query params to match the given feature list (presence-only).
+ * Removes any existing `feature.*` params, then adds each selected feature as `feature.<name>`.
+ * Reloads by default so boot-time consumers (e.g. AI registration) pick up the change.
+ * @public
+ */
+export declare const setActivatedFeatures: (features: string[], options?: SetActivatedFeaturesOptions) => void;
+
+/**
+ * Options for {@link setActivatedFeatures}.
+ * @public
+ */
+export declare type SetActivatedFeaturesOptions = {
+    /**
+     * When true (default), navigates to the updated URL so boot-time consumers re-evaluate.
+     * When false, updates the URL via `history.replaceState` without reloading.
+     */
+    reload?: boolean;
+};
+
 export declare const SHORTCUT_BLOCKED_DEFAULT_MESSAGE = "This shortcut is currently unavailable in this context.";
 
 export declare const SHORTCUT_BLOCKED_DEFAULT_TITLE = "Shortcut blocked";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.497.0",
+  "version": "14.499.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -29,18 +29,18 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.497.0",
-    "@genesislcap/genx": "14.497.0",
-    "@genesislcap/rollup-builder": "14.497.0",
-    "@genesislcap/ts-builder": "14.497.0",
-    "@genesislcap/uvu-playwright-builder": "14.497.0",
-    "@genesislcap/vite-builder": "14.497.0",
-    "@genesislcap/webpack-builder": "14.497.0",
+    "@genesislcap/foundation-testing": "14.499.0",
+    "@genesislcap/genx": "14.499.0",
+    "@genesislcap/rollup-builder": "14.499.0",
+    "@genesislcap/ts-builder": "14.499.0",
+    "@genesislcap/uvu-playwright-builder": "14.499.0",
+    "@genesislcap/vite-builder": "14.499.0",
+    "@genesislcap/webpack-builder": "14.499.0",
     "@types/json-schema": "^7.0.11"
   },
   "dependencies": {
-    "@genesislcap/expression-builder": "14.497.0",
-    "@genesislcap/foundation-logger": "14.497.0",
+    "@genesislcap/expression-builder": "14.499.0",
+    "@genesislcap/foundation-logger": "14.499.0",
     "@microsoft/fast-components": "2.30.6",
     "@microsoft/fast-element": "1.14.0",
     "@microsoft/fast-foundation": "2.50.0",
@@ -58,5 +58,5 @@
     "access": "public"
   },
   "customElements": "dist/custom-elements.json",
-  "gitHead": "8859a3cd83bd40fc5e5bbff9be5ebe02380fb6ec"
+  "gitHead": "49903bfdc57c5c5a7dd0d711d9717908df0b7ac7"
 }