cotomy 0.3.9 → 0.3.11

package/README.md

@@ -48,6 +48,7 @@ The View layer provides thin wrappers around DOM elements and window events.
   - `CotomyElement.byId(id, type?)`
   - `CotomyElement.empty(type?)` — Creates a hidden placeholder element
 - Identity & matching
+  - `instanceId: string | null | undefined` — Public getter backed by `data-cotomy-instance`
   - `id: string | null | undefined`
   - `generateId(prefix = "__cotomy_elem__"): this`
   - `is(selector: string): boolean` — Parent-aware matching helper
@@ -75,6 +76,7 @@ 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`
+  - `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
@@ -130,6 +132,7 @@ npx vitest run tests/view.spec.ts -t "assigns fresh scope ids when cloning, incl
 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, 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.

package/dist/browser/cotomy.js

@@ -1283,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);
     }