cotomy 0.3.8 → 0.3.10

package/README.md

@@ -75,7 +75,8 @@ The View layer provides thin wrappers around DOM elements and window events.
   - `append(child): this` / `prepend(child): this` / `appendAll(children): this`
   - `insertBefore(sibling): this` / `insertAfter(sibling): this`
   - `appendTo(target): this` / `prependTo(target): this`
-  - `clone(type?): CotomyElement` - Returns a deep-cloned element, optionally typed, and reassigns new `data-cotomy-scopeid` values to the clone and all descendants so scoped CSS and event registries stay isolated
+  - `comesBefore(target): boolean` / `comesAfter(target): boolean` — Checks DOM order (returns `false` for the same element or disconnected nodes)
+  - `clone(type?): CotomyElement` - Returns a deep-cloned element, optionally typed, and reassigns new `data-cotomy-instance`/`data-cotomy-scopeid` values (and strips `data-cotomy-moving`). Cloning an invalidated element (`data-cotomy-invalidated`) throws.
   - `clear(): this` — Removes all descendants and text
   - `remove(): void` — Explicitly non-chainable after removal
 - Geometry & visibility
@@ -127,9 +128,13 @@ The scoped CSS replacement and scope-id isolation logic are covered by `tests/vi
 ```bash
 npx vitest run tests/view.spec.ts -t "constructs from multiple sources and applies scoped css"
 npx vitest run tests/view.spec.ts -t "assigns fresh scope ids when cloning, including descendants"
+npx vitest run tests/view.spec.ts -t "regenerates instance ids and lifecycle hooks when cloning"
+npx vitest run tests/view.spec.ts -t "strips moving flags when cloning"
+npx vitest run tests/view.spec.ts -t "throws when cloning an invalidated element"
+npx vitest run tests/view.spec.ts -t "compares document order with comesBefore/comesAfter"
 ```
 
-The first command ensures `[scope]` expands to `[data-cotomy-scopeid="..."]` in injected styles, while the second confirms that cloning reassigns new `data-cotomy-scopeid` attributes to the cloned tree.
+The first command ensures `[scope]` expands to `[data-cotomy-scopeid="..."]` in injected styles, the second confirms that cloning reassigns new `data-cotomy-scopeid` attributes to the cloned tree, the third verifies fresh `data-cotomy-instance` values and lifecycle hooks, and the last two cover stripping transit flags and rejecting invalidated nodes during cloning.
 
 ### CotomyMetaElement
 

package/dist/browser/cotomy.js

@@ -1009,9 +1009,16 @@ class CotomyElement {
     }
     clone(type) {
         const ctor = (type ?? CotomyElement);
-        const cloned = new ctor(this.element.cloneNode(true));
-        cloned.attribute("data-cotomy-scopeid", null);
-        cloned.find("[data-cotomy-scopeid]").forEach(e => e.attribute("data-cotomy-scopeid", null));
+        const ATTRIBUTES_TO_STRIP = ["data-cotomy-instance", "data-cotomy-scopeid", "data-cotomy-moving"];
+        const clonedElement = this.element.cloneNode(true);
+        if (clonedElement.hasAttribute("data-cotomy-invalidated")) {
+            throw new Error("Cannot clone an invalidated CotomyElement.");
+        }
+        ATTRIBUTES_TO_STRIP.forEach(attr => {
+            clonedElement.removeAttribute(attr);
+            clonedElement.querySelectorAll(`[${attr}]`).forEach(el => el.removeAttribute(attr));
+        });
+        const cloned = new ctor(clonedElement);
         return cloned;
     }
     get tagname() {
@@ -1276,6 +1283,18 @@ class CotomyElement {
     get isRightViewport() {
         return this.element.getBoundingClientRect().left > window.innerWidth;
     }
+    comesBefore(target) {
+        const pos = this.element.compareDocumentPosition(target.element);
+        if (pos & Node.DOCUMENT_POSITION_DISCONNECTED)
+            return false;
+        return (pos & Node.DOCUMENT_POSITION_FOLLOWING) !== 0;
+    }
+    comesAfter(target) {
+        const pos = this.element.compareDocumentPosition(target.element);
+        if (pos & Node.DOCUMENT_POSITION_DISCONNECTED)
+            return false;
+        return (pos & Node.DOCUMENT_POSITION_PRECEDING) !== 0;
+    }
     hasAttribute(name) {
         return this.element.hasAttribute(name);
     }