mount-observer 0.1.0 → 0.1.2

package/types.d.ts

@@ -1,13 +1,33 @@
 // Core types for MountObserver v2 - Polyfill Supported Scenario I
 
+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';
+
 export interface MountInit {
     whereElementMatches: string;
     whereAttr?: WhereAttr;
+    whereInstanceOf?: Constructor | Constructor[];
+    whereMediaMatches?: string | MediaQueryList;
+    whereOutside?: string;
     import?: string | ImportSpec | Array<string | ImportSpec>;
     do?: DoCallback | DoCallbacks;
     loadingEagerness?: 'eager' | 'lazy';
     assignGingerly?: Record<string, any>;
     map?: MapConfig;
+    getPlayByPlay?: boolean;
+    mountedElemEmits?: EventConfig | EventConfig[];
 }
 
 export interface MapConfig {
@@ -17,6 +37,11 @@ export interface MapConfig {
 export interface MapEntry {
     instanceOf?: string;
     mapsTo?: string;
+    /**
+     * Only notify the presence of this attribute
+     * the first time it is seen
+     */
+    once?: boolean;
     [key: string]: any;
 }
 
@@ -57,23 +82,33 @@ 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>;
 }
 
 export interface IMountEvent extends Event {
     matchingElement: Element;
     modules: any[];
+    mountInit: MountInit;
 }
 
 export interface IDismountEvent extends Event {
     matchingElement: Element;
+    reason: DismountReason;
+    mountInit: MountInit;
 }
 
 export interface IAttrChangeEvent extends Event {
     changes: AttrChange[];
+    mountInit: MountInit;
 }
 
 export interface AttrChange {

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
+}

package/constants.js

@@ -1,6 +0,0 @@
-// Constants for MountObserver
-export const loadEventName = 'load';
-export const mountEventName = 'mount';
-export const dismountEventName = 'dismount';
-export const disconnectEventName = 'disconnect';
-export const attrchangeEventName = 'attrchange';

package/constants.ts

@@ -1,7 +0,0 @@
-// Constants for MountObserver
-
-export const loadEventName = 'load';
-export const mountEventName = 'mount';
-export const dismountEventName = 'dismount';
-export const disconnectEventName = 'disconnect';
-export const attrchangeEventName = 'attrchange';