@genesislcap/foundation-utils 14.496.2-alpha-438fb6e.0 → 14.496.2-alpha-da9ccbd.0

package/dist/custom-elements.json

@@ -250,59 +250,6 @@
         }
       ]
     },
-    {
-      "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/data/inMemoryDatabase.ts",
@@ -501,6 +448,29 @@
         }
       ]
     },
+    {
+      "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/design-system/design-system.ts",
@@ -703,29 +673,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/encoding/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",

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

@@ -71,16 +71,16 @@ export declare const LifecycleMixin: <T extends ConstructableLifecycleHandler>(B
          **/
         #_shouldForceLifecycle: boolean;
         /**
-         * Set once a microtask has elapsed since a blocked ('reflow') disconnect. A blocked disconnect
-         * promises the consumer "you'll reconnect imminently, don't tear anything down" - but some
-         * consumers (e.g. a grid wrapper) don't fully trust that promise and run their own defensive
-         * cleanup on a microtask if they're still disconnected by then, bypassing `shouldRunDisconnect`
-         * entirely. Once that window has passed we can no longer assume nothing was torn down, so the
-         * paired reconnect must not stay blocked either, or the consumer never gets a chance to
-         * re-initialize what it already destroyed.
+         * Set once a short grace period has elapsed since a blocked ('reflow') disconnect. Some
+         * consumers run defensive cleanup shortly after despite the block - and don't necessarily use
+         * a plain microtask to do it (e.g. FAST's `DOM.queueUpdate` scheduler, which a consumer's own
+         * reconnect logic may also be deferred through, can resolve after our microtask has already
+         * fired, making a same-microtask check unreliable). A macrotask-scale grace period via
+         * `setTimeout` is cheap here and outlasts any such scheduler, so once it has passed the paired
+         * reconnect must not stay blocked, or the consumer never re-initializes.
          * @internal
          **/
-        #_blockedDisconnectSurvivedMicrotask: boolean;
+        #_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;kBA0CtD,GAAG,EAAE;QAxC1B,iBAAiB;qBACJ,SAAS;QAEtB;;;YAGI;2BACe,MAAM;QACzB;;;YAGI;0BACc,OAAO;QACzB;;;;;;;YAOI;0BACc,MAAM,CAAC,OAAO;QAChC;;;;YAII;gCACoB,OAAO;QAC/B;;;;;;;;;YASI;8CACkC,OAAO;QAM7C;;;;;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"}
+{"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;kBA0CtD,GAAG,EAAE;QAxC1B,iBAAiB;qBACJ,SAAS;QAEtB;;;YAGI;2BACe,MAAM;QACzB;;;YAGI;0BACc,OAAO;QACzB;;;;;;;YAOI;0BACc,MAAM,CAAC,OAAO;QAChC;;;;YAII;gCACoB,OAAO;QAC/B;;;;;;;;;YASI;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/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, __blockedDisconnectSurvivedMicrotask, __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);
@@ -43,16 +43,16 @@ export const LifecycleMixin = (Base) => { var _instances, __container, __latestT
              **/
             __shouldForceLifecycle.set(this, false);
             /**
-             * Set once a microtask has elapsed since a blocked ('reflow') disconnect. A blocked disconnect
-             * promises the consumer "you'll reconnect imminently, don't tear anything down" - but some
-             * consumers (e.g. a grid wrapper) don't fully trust that promise and run their own defensive
-             * cleanup on a microtask if they're still disconnected by then, bypassing `shouldRunDisconnect`
-             * entirely. Once that window has passed we can no longer assume nothing was torn down, so the
-             * paired reconnect must not stay blocked either, or the consumer never gets a chance to
-             * re-initialize what it already destroyed.
+             * Set once a short grace period has elapsed since a blocked ('reflow') disconnect. Some
+             * consumers run defensive cleanup shortly after despite the block - and don't necessarily use
+             * a plain microtask to do it (e.g. FAST's `DOM.queueUpdate` scheduler, which a consumer's own
+             * reconnect logic may also be deferred through, can resolve after our microtask has already
+             * fired, making a same-microtask check unreliable). A macrotask-scale grace period via
+             * `setTimeout` is cheap here and outlasts any such scheduler, so once it has passed the paired
+             * reconnect must not stay blocked, or the consumer never re-initializes.
              * @internal
              **/
-            __blockedDisconnectSurvivedMicrotask.set(this, false);
+            __blockedDisconnectSurvivedGracePeriod.set(this, false);
         }
         /**
          * @privateRemarks
@@ -138,7 +138,7 @@ export const LifecycleMixin = (Base) => { var _instances, __container, __latestT
     __hasFirstLoaded = new WeakMap(),
     __cleanupTimeout = new WeakMap(),
     __shouldForceLifecycle = new WeakMap(),
-    __blockedDisconnectSurvivedMicrotask = new WeakMap(),
+    __blockedDisconnectSurvivedGracePeriod = new WeakMap(),
     _instances = new WeakSet(),
     __blockLifecycleDueToTokenChange = function __blockLifecycleDueToTokenChange(lifecycleType) {
         var _b, _c;
@@ -159,12 +159,12 @@ export const LifecycleMixin = (Base) => { var _instances, __container, __latestT
                 __classPrivateFieldSet(this, __hasFirstLoaded, false, "f");
             }
             else {
-                // Blocked disconnect: track whether a microtask elapses before the paired reconnect
-                // arrives. See `#_blockedDisconnectSurvivedMicrotask` for why this matters.
-                __classPrivateFieldSet(this, __blockedDisconnectSurvivedMicrotask, false, "f");
-                queueMicrotask(() => {
-                    __classPrivateFieldSet(this, __blockedDisconnectSurvivedMicrotask, true, "f");
-                });
+                // 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");
@@ -174,7 +174,7 @@ export const LifecycleMixin = (Base) => { var _instances, __container, __latestT
             }, CLEANUP_TIMEOUT_MS), "f");
         }
         else if (lifecycleType === 'reconnect') {
-            result = tokensDifferent && !__classPrivateFieldGet(this, __blockedDisconnectSurvivedMicrotask, "f");
+            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

@@ -9094,7 +9094,7 @@
             },
             {
               "kind": "Content",
-              "text": ";\n        #_shouldForceLifecycle: boolean;\n        #_blockedDisconnectSurvivedMicrotask: boolean;\n        cloneNode(deep?: boolean): "
+              "text": ";\n        #_shouldForceLifecycle: boolean;\n        #_blockedDisconnectSurvivedGracePeriod: boolean;\n        cloneNode(deep?: boolean): "
             },
             {
               "kind": "Reference",

package/dist/foundation-utils.d.ts

@@ -1019,16 +1019,16 @@ export declare const LifecycleMixin: <T extends ConstructableLifecycleHandler>(B
          **/
         #_shouldForceLifecycle: boolean;
         /**
-         * Set once a microtask has elapsed since a blocked ('reflow') disconnect. A blocked disconnect
-         * promises the consumer "you'll reconnect imminently, don't tear anything down" - but some
-         * consumers (e.g. a grid wrapper) don't fully trust that promise and run their own defensive
-         * cleanup on a microtask if they're still disconnected by then, bypassing `shouldRunDisconnect`
-         * entirely. Once that window has passed we can no longer assume nothing was torn down, so the
-         * paired reconnect must not stay blocked either, or the consumer never gets a chance to
-         * re-initialize what it already destroyed.
+         * Set once a short grace period has elapsed since a blocked ('reflow') disconnect. Some
+         * consumers run defensive cleanup shortly after despite the block - and don't necessarily use
+         * a plain microtask to do it (e.g. FAST's `DOM.queueUpdate` scheduler, which a consumer's own
+         * reconnect logic may also be deferred through, can resolve after our microtask has already
+         * fired, making a same-microtask check unreliable). A macrotask-scale grace period via
+         * `setTimeout` is cheap here and outlasts any such scheduler, so once it has passed the paired
+         * reconnect must not stay blocked, or the consumer never re-initializes.
          * @internal
          **/
-        #_blockedDisconnectSurvivedMicrotask: boolean;
+        #_blockedDisconnectSurvivedGracePeriod: boolean;
         /**
          * @privateRemarks
          * Rather than using the basic implementation of cloning we run a copy constructor (deepClone)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@genesislcap/foundation-utils",
   "description": "Genesis Foundation Utils",
-  "version": "14.496.2-alpha-438fb6e.0",
+  "version": "14.496.2-alpha-da9ccbd.0",
   "sideEffects": false,
   "license": "SEE LICENSE IN license.txt",
   "main": "dist/esm/index.js",
@@ -29,18 +29,18 @@
     }
   },
   "devDependencies": {
-    "@genesislcap/foundation-testing": "14.496.2-alpha-438fb6e.0",
-    "@genesislcap/genx": "14.496.2-alpha-438fb6e.0",
-    "@genesislcap/rollup-builder": "14.496.2-alpha-438fb6e.0",
-    "@genesislcap/ts-builder": "14.496.2-alpha-438fb6e.0",
-    "@genesislcap/uvu-playwright-builder": "14.496.2-alpha-438fb6e.0",
-    "@genesislcap/vite-builder": "14.496.2-alpha-438fb6e.0",
-    "@genesislcap/webpack-builder": "14.496.2-alpha-438fb6e.0",
+    "@genesislcap/foundation-testing": "14.496.2-alpha-da9ccbd.0",
+    "@genesislcap/genx": "14.496.2-alpha-da9ccbd.0",
+    "@genesislcap/rollup-builder": "14.496.2-alpha-da9ccbd.0",
+    "@genesislcap/ts-builder": "14.496.2-alpha-da9ccbd.0",
+    "@genesislcap/uvu-playwright-builder": "14.496.2-alpha-da9ccbd.0",
+    "@genesislcap/vite-builder": "14.496.2-alpha-da9ccbd.0",
+    "@genesislcap/webpack-builder": "14.496.2-alpha-da9ccbd.0",
     "@types/json-schema": "^7.0.11"
   },
   "dependencies": {
-    "@genesislcap/expression-builder": "14.496.2-alpha-438fb6e.0",
-    "@genesislcap/foundation-logger": "14.496.2-alpha-438fb6e.0",
+    "@genesislcap/expression-builder": "14.496.2-alpha-da9ccbd.0",
+    "@genesislcap/foundation-logger": "14.496.2-alpha-da9ccbd.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": "6dc7bbda02ba69207921891ffbd1f39b582ac780"
+  "gitHead": "daac29f621ee844cc6e269c0b8bd52c56bff8cf0"
 }