ddan-js 3.7.0 → 3.8.0

package/bin/modules/html/elementObserver.d.ts

@@ -0,0 +1,41 @@
+type ElementObserverCallbacks = {
+    onAppear?: (el: Element) => void;
+    onDisappear?: (el: Element) => void;
+    onClick?: (el: Element, ev: MouseEvent) => void;
+};
+type ObserveOptions = {
+    root?: Element;
+    childList?: boolean;
+    subtree?: boolean;
+};
+export declare class ElementObserver {
+    private callbacks;
+    private selector;
+    private observer;
+    private elementsSeen;
+    private clickHandlers;
+    private isObserving;
+    private root;
+    constructor(callbacks?: ElementObserverCallbacks);
+    /** 初始化 MutationObserver */
+    private initObserver;
+    private collectAdded;
+    private collectRemoved;
+    /** 触发回调 */
+    private triggerCallback;
+    /** 点击事件绑定 */
+    private bindClick;
+    /** 点击事件解绑 */
+    private unbindClick;
+    /** 开始观察 */
+    observe(selector: string, options?: ObserveOptions): void;
+    /** 动态修改 selector */
+    updateObserver(selector?: string): boolean;
+    /** 停止观察 */
+    disconnect(): void;
+    /** 更新回调函数 */
+    updateCallbacks(callbacks: ElementObserverCallbacks): void;
+    /** 销毁实例 */
+    destroy(): void;
+}
+export {};

package/bin/modules/{html.d.ts → html/index.d.ts}

@@ -1,3 +1,4 @@
+import { ElementObserver } from "./elementObserver";
 declare const _default: {
     dataURLtoFile: (dataurl: any, filename: any) => File;
     dataURLtoBlob: (dataurl: any) => Blob;
@@ -33,5 +34,14 @@ declare const _default: {
         width: number;
         height: number;
     }>;
+    ElementObserver: typeof ElementObserver;
+    watchTextChange: (element: HTMLElement, callback: (newText: string, oldText: string) => void) => (() => void) | undefined;
+    watchAttrChange: typeof import("./watch").watchAttrChange;
+    watchElementChange: (element: Element | null, options?: {
+        onText?: ((newText: string, oldText: string) => void) | undefined;
+        onAttr?: ((name: string, newValue: string | null, oldValue: string | null) => void) | undefined;
+        attrFilter?: string[] | null | undefined;
+    } | undefined) => (() => void) | undefined;
+    waitForElement: (selector: string, timeout?: number) => Promise<Element | null>;
 };
 export default _default;

package/bin/modules/html/watch.d.ts

@@ -0,0 +1,28 @@
+/**
+ *
+ * @param element
+ * @param callback
+ * @returns
+ */
+declare function watchTextChange(element: HTMLElement, callback: (newText: string, oldText: string) => void): (() => void) | undefined;
+/**
+ *
+ * @param element
+ * @param callback
+ * @param attrs
+ * @returns
+ */
+export declare function watchAttrChange(element: HTMLElement | null | undefined, callback: (attrName: string, newValue: string | null, oldValue: string | null) => void, attrs?: string[]): (() => void) | undefined;
+declare function watchElementChange(element: Element | null, options?: {
+    onText?: (newText: string, oldText: string) => void;
+    onAttr?: (name: string, newValue: string | null, oldValue: string | null) => void;
+    attrFilter?: string[] | null;
+}): (() => void) | undefined;
+declare function waitForElement(selector: string, timeout?: number): Promise<Element | null>;
+declare const _default: {
+    watchTextChange: typeof watchTextChange;
+    watchAttrChange: typeof watchAttrChange;
+    watchElementChange: typeof watchElementChange;
+    waitForElement: typeof waitForElement;
+};
+export default _default;

package/bin/tiny/mini.d.ts

@@ -118,6 +118,15 @@ declare const dMini: {
             width: number;
             height: number;
         }>;
+        ElementObserver: typeof import("../modules/html/elementObserver").ElementObserver;
+        watchTextChange: (element: HTMLElement, callback: (newText: string, oldText: string) => void) => (() => void) | undefined;
+        watchAttrChange: typeof import("../modules/html/watch").watchAttrChange;
+        watchElementChange: (element: Element | null, options?: {
+            onText?: ((newText: string, oldText: string) => void) | undefined;
+            onAttr?: ((name: string, newValue: string | null, oldValue: string | null) => void) | undefined;
+            attrFilter?: string[] | null | undefined;
+        } | undefined) => (() => void) | undefined;
+        waitForElement: (selector: string, timeout?: number) => Promise<Element | null>;
     };
 };
 export default dMini;

package/bin/tiny/web.d.ts

@@ -150,6 +150,15 @@ declare const dWeb: {
             width: number;
             height: number;
         }>;
+        ElementObserver: typeof import("../modules/html/elementObserver").ElementObserver;
+        watchTextChange: (element: HTMLElement, callback: (newText: string, oldText: string) => void) => (() => void) | undefined;
+        watchAttrChange: typeof import("../modules/html/watch").watchAttrChange;
+        watchElementChange: (element: Element | null, options?: {
+            onText?: ((newText: string, oldText: string) => void) | undefined;
+            onAttr?: ((name: string, newValue: string | null, oldValue: string | null) => void) | undefined;
+            attrFilter?: string[] | null | undefined;
+        } | undefined) => (() => void) | undefined;
+        waitForElement: (selector: string, timeout?: number) => Promise<Element | null>;
     };
     rsa: {
         generateKeys: () => Promise<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ddan-js",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "description": "",
   "keywords": [
     "ddan-js",
@@ -19,14 +19,17 @@
   ],
   "main": "bin/ddan-js.js",
   "module": "bin/ddan-js.mjs",
-  "browser": "bin/ddan-js.browser.js",
+  "browser": "bin/ddan-browser.js",
   "types": "bin/index.d.ts",
   "exports": {
     ".": {
       "types": "./bin/index.d.ts",
       "import": "./bin/ddan-js.mjs",
       "require": "./bin/ddan-js.js",
-      "browser": "./bin/ddan-js.browser.js"
+      "browser": {
+        "import": "./bin/ddan-browser.mjs",
+        "require": "./bin/ddan-browser.js"
+      }
     },
     "./upload": {
       "types": "./bin/upload.d.ts",