@leavittsoftware/web 9.3.0 → 9.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leavittsoftware/web",
-  "version": "9.3.0",
+  "version": "9.4.0",
   "license": "Apache-2.0",
   "description": "",
   "files": [
@@ -44,5 +44,5 @@
     "url": "https://github.com/LeavittSoftware/titanium-elements/issues"
   },
   "homepage": "https://github.com/LeavittSoftware/titanium-elements/#readme",
-  "gitHead": "e756772529ab6d5c8b94e02448c3d6b0ba0c1c6a"
+  "gitHead": "4f119b3ace4944d7845f7d22b279bbf9469de34a"
 }

package/titanium/helpers/helpers.d.ts

@@ -6,6 +6,7 @@ export { installMediaQueryWatcher } from './install-media-query-watcher';
 export { getSearchTokens } from './get-search-token';
 export { Debouncer } from './debouncer';
 export { LoadWhile } from './load-while';
+export { promiseTracking } from './promise-tracking';
 export { join } from './join';
 export { delay } from './delay';
 export { middleEllipsis } from './middle-ellipsis';

package/titanium/helpers/helpers.js

@@ -6,6 +6,7 @@ export { installMediaQueryWatcher } from './install-media-query-watcher';
 export { getSearchTokens } from './get-search-token';
 export { Debouncer } from './debouncer';
 export { LoadWhile } from './load-while';
+export { promiseTracking } from './promise-tracking';
 export { join } from './join';
 export { delay } from './delay';
 export { middleEllipsis } from './middle-ellipsis';

package/titanium/helpers/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/titanium/helpers/promise-tracking.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Decorates a reactive boolean accessor so that calling the generated method
+ * sets the property to `true` while the supplied promise is pending, and
+ * back to `false` once it resolves or rejects. Re-throws errors.
+ *
+ * Reentrancy: if the method is called multiple times concurrently, the
+ * property only flips back to `false` after ALL outstanding promises settle.
+ *
+ * Because the method name is a runtime string, TypeScript can't see it on
+ * the host class. Consumers add a one-line `declare` next to the accessor.
+ *
+ * @param methodName The name of the method to add to the host prototype.
+ *
+ * @example
+ * ```ts
+ * \@promiseTracking('trackLoadingPromise')
+ * \@state() accessor isLoading = false;
+ * declare trackLoadingPromise: (p: Promise<unknown>) => Promise<void>;
+ *
+ * await this.trackLoadingPromise(api.load());
+ * ```
+ */
+export declare function promiseTracking(methodName: string): (target: object, propertyKey: string | symbol, _descriptor: PropertyDescriptor) => void;
+//# sourceMappingURL=promise-tracking.d.ts.map

package/titanium/helpers/promise-tracking.js

@@ -0,0 +1,45 @@
+/**
+ * Decorates a reactive boolean accessor so that calling the generated method
+ * sets the property to `true` while the supplied promise is pending, and
+ * back to `false` once it resolves or rejects. Re-throws errors.
+ *
+ * Reentrancy: if the method is called multiple times concurrently, the
+ * property only flips back to `false` after ALL outstanding promises settle.
+ *
+ * Because the method name is a runtime string, TypeScript can't see it on
+ * the host class. Consumers add a one-line `declare` next to the accessor.
+ *
+ * @param methodName The name of the method to add to the host prototype.
+ *
+ * @example
+ * ```ts
+ * \@promiseTracking('trackLoadingPromise')
+ * \@state() accessor isLoading = false;
+ * declare trackLoadingPromise: (p: Promise<unknown>) => Promise<void>;
+ *
+ * await this.trackLoadingPromise(api.load());
+ * ```
+ */
+export function promiseTracking(methodName) {
+    return function (target, propertyKey, _descriptor) {
+        const counterKey = Symbol(`__${String(propertyKey)}_count__`);
+        Object.defineProperty(target, methodName, {
+            configurable: true,
+            writable: true,
+            value: async function (promise) {
+                this[counterKey] = (this[counterKey] ?? 0) + 1;
+                this[propertyKey] = true;
+                try {
+                    await promise;
+                }
+                finally {
+                    this[counterKey]--;
+                    if (this[counterKey] === 0) {
+                        this[propertyKey] = false;
+                    }
+                }
+            },
+        });
+    };
+}
+//# sourceMappingURL=promise-tracking.js.map

package/titanium/helpers/promise-tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise-tracking.js","sourceRoot":"","sources":["promise-tracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IAChD,OAAO,UAAU,MAAc,EAAE,WAA4B,EAAE,WAA+B;QAC5F,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAE9D,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE;YACxC,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,KAAK,WAAsB,OAAyB;gBACzD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBAC/C,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC;gBAChB,CAAC;wBAAS,CAAC;oBACT,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;oBACnB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC3B,IAAI,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;oBAC5B,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}