mount-observer 0.1.1 → 0.1.3

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "mount-observer",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Observe and act on css matches.",
   "main": "MountObserver.js",
   "module": "MountObserver.js",
   "dependencies": {
-    "assign-gingerly": "0.0.2"
+    "assign-gingerly": "0.0.6"
   },
   "devDependencies": {
-    "@playwright/test": "1.58.0",
+    "@playwright/test": "1.58.2",
     "spa-ssi": "0.0.26"
   },
   "exports": {
@@ -19,6 +19,30 @@
     "./MountObserver.js": {
       "default": "./MountObserver.js",
       "types": "./MountObserver.ts"
+    },
+    "./whereOutside.js": {
+      "default": "./whereOutside.js",
+      "types": "./whereOutside.ts"
+    },
+    "./emitEvents.js": {
+      "default": "./emitEvents.js",
+      "types": "./emitEvents.ts"
+    },
+    "./attrChanges.js": {
+      "default": "./attrChanges.js",
+      "types": "./attrChanges.ts"
+    },
+    "./arr.js": {
+      "default": "./arr.js",
+      "types": "./arr.ts"
+    },
+    "./EvtRt.js": {
+      "default": "./EvtRt.js",
+      "types": "./EvtRt.ts"
+    },
+    "./DefineCustomElementHandler.js": {
+      "default": "./DefineCustomElementHandler.js",
+      "types": "./DefineCustomElementHandler.ts"
     }
   },
   "files": [

package/types.d.ts

@@ -2,6 +2,15 @@
 
 export type Constructor = new (...args: any[]) => any;
 
+export type EventConstructor = {new(...args: any[]): Event};
+
+export interface EventConfig {
+    event: string | EventConstructor;
+    args?: any | any[];
+    eventProps?: Record<string, any>;
+    oncePerMountedElement?: boolean;
+}
+
 export type DismountReason = 
     | 'media-query-failed'
     | 'where-element-matches-failed';
@@ -11,12 +20,19 @@ export interface MountInit {
     whereAttr?: WhereAttr;
     whereInstanceOf?: Constructor | Constructor[];
     whereMediaMatches?: string | MediaQueryList;
+    whereOutside?: string;
     import?: string | ImportSpec | Array<string | ImportSpec>;
-    do?: DoCallback | DoCallbacks;
+    do?: string | DoCallback | (string | DoCallback)[];
     loadingEagerness?: 'eager' | 'lazy';
-    assignGingerly?: Record<string, any>;
+    assignOnMount?: Record<string, any>;
+    assignOnDismount?: Record<string, any>;
     map?: MapConfig;
     getPlayByPlay?: boolean;
+    mountedElemEmits?: EventConfig | EventConfig[];
+    reference?: number | number[];
+    //allow handler classes or functions
+    //to be passed some custom information
+    customData?: unknown;
 }
 
 export interface MapConfig {
@@ -51,40 +67,47 @@ export interface ImportSpec {
 export interface MountContext {
     modules: any[];
     observer: IMountObserver;
-    observeInfo: ObserveInfo;
-}
-
-export interface ObserveInfo {
     rootNode: Node;
+    mountInit: MountInit
 }
 
-export type DoCallback = (matchingElement: Element, context: MountContext) => void;
 
-export interface DoCallbacks {
-    mount?: (matchingElement: Element, context: MountContext) => void;
-    dismount?: (matchingElement: Element, context: MountContext) => void;
-    disconnect?: (matchingElement: Element, context: MountContext) => void;
-    reconnect?: (matchingElement: Element, context: MountContext) => void;
-}
+
+export type DoCallback = (mountedElement: Element, context: MountContext) => void;
+
+// export interface DoCallbacks {
+//     mount?: (mountedElement: Element, context: MountContext) => void;
+//     dismount?: (mountedElement: Element, context: MountContext) => void;
+//     disconnect?: (mountedElement: Element, context: MountContext) => void;
+//     reconnect?: (mountedElement: Element, context: MountContext) => void;
+// }
 
 export interface MountObserverOptions {
     disconnectedSignal?: AbortSignal;
 }
 
+export interface WeakDual<T extends Object>{
+    weakSet: WeakSet<T>,
+    setWeak: Set<WeakRef<T>>
+}
+
 export interface IMountObserver extends EventTarget {
     observe(rootNode: Node): Promise<void>;
     disconnect(): void;
     disconnectedSignal: AbortSignal;
+    assignGingerly(config: Record<string, any> | undefined): Promise<void>;
+    getNotifier(element: Element): EventTarget;
 }
 
 export interface IMountEvent extends Event {
-    matchingElement: Element;
+    mountedElement: Element;
     modules: any[];
     mountInit: MountInit;
+    mountContext: MountContext;
 }
 
 export interface IDismountEvent extends Event {
-    matchingElement: Element;
+    mountedElement: Element;
     reason: DismountReason;
     mountInit: MountInit;
 }

package/whereOutside.js

@@ -0,0 +1,19 @@
+/**
+ * Check if an element is outside (not inside) any ancestor matching a selector.
+ * This implements "donut hole" scoping.
+ *
+ * @param rootNode - The root node to stop traversal at (not checked against selector)
+ * @param matchCandidate - The element to check
+ * @param outside - CSS selector for excluding ancestors
+ * @returns true if element is outside all matching ancestors, false otherwise
+ */
+export function whereOutside(rootNode, matchCandidate, outside) {
+    let current = matchCandidate.parentElement;
+    while (current && current !== rootNode) {
+        if (current.matches(outside)) {
+            return false; // Found an excluding ancestor
+        }
+        current = current.parentElement;
+    }
+    return true; // No excluding ancestors found
+}

package/whereOutside.ts

@@ -0,0 +1,25 @@
+/**
+ * Check if an element is outside (not inside) any ancestor matching a selector.
+ * This implements "donut hole" scoping.
+ * 
+ * @param rootNode - The root node to stop traversal at (not checked against selector)
+ * @param matchCandidate - The element to check
+ * @param outside - CSS selector for excluding ancestors
+ * @returns true if element is outside all matching ancestors, false otherwise
+ */
+export function whereOutside(
+    rootNode: Node,
+    matchCandidate: Element,
+    outside: string
+): boolean {
+    let current = matchCandidate.parentElement;
+    
+    while (current && current !== rootNode) {
+        if (current.matches(outside)) {
+            return false;  // Found an excluding ancestor
+        }
+        current = current.parentElement;
+    }
+    
+    return true;  // No excluding ancestors found
+}