intelliwaketssveltekitv25 1.0.45 → 1.0.47

package/dist/Functions.d.ts

@@ -25,13 +25,20 @@ export declare const DownloadBase64Data: (fileName: string, base64: string) => v
 export declare function CopyRefToClipboard(ref: HTMLElement | null | undefined, tryFormatted?: boolean): boolean;
 export declare const TableIDToExcel: (tableID: string, fileName?: string, appendDateTime?: boolean) => void;
 export declare const DoIDsMatch: (a: any, b: any) => boolean;
+type Focusable = HTMLElement | HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
 /**
- * A Svelte "Use Action" that transfers focus to the current element when the object is added to the DOM
- * Usage: <input use:autoFocus />
+ * Manages automatic focusing of an element, with the ability to enable or disable the functionality dynamically.
  *
- * @param el
+ * @param {Focusable} el - The element to auto-focus. The element should implement the `focus()` method and be connected to the DOM.
+ * @param {boolean} [enabled=true] - A flag indicating whether auto-focus should be initially enabled.
+ * @return {Object} An object with methods to update the enabled state or destroy the auto-focus behavior:
+ *                  - `update(nextEnabled: boolean)`: Updates the enabled state.
+ *                  - `destroy()`: Cancels the auto-focus behavior and cleans up resources.
  */
-export declare function autoFocus(el: HTMLElement | HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | never): void;
+export declare function autoFocus(el: Focusable, enabled?: boolean): {
+    update(nextEnabled: boolean): void;
+    destroy(): void;
+};
 export declare function autoGrow(node: HTMLTextAreaElement, _value?: string | null): {
     update(): void;
     destroy(): void;
@@ -214,3 +221,4 @@ export type TInputNumberAttributes = Omit<HTMLInputAttributes, 'value' | 'this'
     thisRef?: HTMLInputElement;
 } & TNumberStringOptions;
 export declare function PageAdvanceSize(pageCount: number): number | null;
+export {};

package/dist/Functions.js

@@ -176,18 +176,50 @@ export const TableIDToExcel = (tableID, fileName, appendDateTime = true) => {
 };
 export const DoIDsMatch = (a, b) => IsEqual(a, b) || IsEqual(a?.id, b?.id);
 /**
- * A Svelte "Use Action" that transfers focus to the current element when the object is added to the DOM
- * Usage: <input use:autoFocus />
+ * Manages automatic focusing of an element, with the ability to enable or disable the functionality dynamically.
  *
- * @param el
+ * @param {Focusable} el - The element to auto-focus. The element should implement the `focus()` method and be connected to the DOM.
+ * @param {boolean} [enabled=true] - A flag indicating whether auto-focus should be initially enabled.
+ * @return {Object} An object with methods to update the enabled state or destroy the auto-focus behavior:
+ *                  - `update(nextEnabled: boolean)`: Updates the enabled state.
+ *                  - `destroy()`: Cancels the auto-focus behavior and cleans up resources.
  */
-export function autoFocus(el) {
-    tick().then(() => {
-        if (!el)
-            console.error('autoFocus el not available');
-        el?.focus();
-    });
+export function autoFocus(el, enabled = true) {
+    let cancelled = false;
+    async function run() {
+        if (!enabled)
+            return;
+        await tick();
+        if (cancelled)
+            return;
+        // Avoid focusing detached nodes
+        if (!el.isConnected)
+            return;
+        // Sometimes modals need the next frame (transitions/portals)
+        requestAnimationFrame(() => {
+            if (!cancelled)
+                el.focus();
+        });
+    }
+    void run();
+    return {
+        update(nextEnabled) {
+            enabled = nextEnabled;
+            void run();
+        },
+        destroy() {
+            cancelled = true;
+        }
+    };
 }
+// export function autoFocus(
+// 	el: HTMLElement | HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | never
+// ) {
+// 	tick().then(() => {
+// 		if (!el) console.error('autoFocus el not available')
+// 		el?.focus()
+// 	})
+// }
 export function autoGrow(node, _value) {
     let userResized = false;
     let pointerDown = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "intelliwaketssveltekitv25",
-  "version": "1.0.45",
+  "version": "1.0.47",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",