cotomy 0.3.6 → 0.3.7

package/README.md

@@ -77,7 +77,7 @@ The View layer provides thin wrappers around DOM elements and window events.
   - `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
   - `clear(): this` — Removes all descendants and text
-  - `remove(): void`
+  - `remove(): void` — Explicitly non-chainable after removal
 - Geometry & visibility
   - `visible: boolean`
   - `width: number` (get/set px)
@@ -141,15 +141,15 @@ The first command ensures `[scope]` expands to `[data-cotomy-scopeid="..."]` in
 - Singleton
   - `CotomyWindow.instance`
   - `initialized: boolean` — Call `initialize()` once after DOM is ready
-  - `initialize(): void`
+  - `initialize(): this`
 - DOM helpers
   - `body: CotomyElement`
-  - `append(element: CotomyElement)`
+  - `append(element: CotomyElement): this`
   - `moveNext(focused: CotomyElement, shift = false)` — Move focus to next/previous focusable
 - Window events
-  - `on(eventOrEvents, handler)` / `off(eventOrEvents, handler?)` / `trigger(event[, Event])` — `eventOrEvents` accepts a single event name or an array. CotomyWindow’s `trigger` also bubbles by default and accepts an `Event` to override the behavior.
-  - `load(handler)` / `ready(handler)`
-  - `resize([handler])` / `scroll([handler])` / `changeLayout([handler])` / `pageshow([handler])`
+  - `on(eventOrEvents, handler): this` / `off(eventOrEvents, handler?): this` / `trigger(event[, Event]): this` — `eventOrEvents` accepts a single event name or an array. CotomyWindow’s `trigger` also bubbles by default and accepts an `Event` to override the behavior.
+  - `load(handler): this` / `ready(handler): this`
+  - `resize([handler]): this` / `scroll([handler]): this` / `changeLayout([handler]): this` / `pageshow([handler]): this`
 - Window state
   - `scrollTop`, `scrollLeft`, `width`, `height`, `documentWidth`, `documentHeight`
   - `reload(): void` (sets internal `reloading` flag), `reloading: boolean`

package/dist/browser/cotomy.js

@@ -1115,6 +1115,7 @@ class CotomyElement {
     }
     setFocus() {
         this.element.focus();
+        return this;
     }
     get visible() {
         if (!this.attached) {
@@ -1877,6 +1878,7 @@ class CotomyWindow {
             });
             this._mutationObserver.observe(this.body.element, { childList: true, subtree: true });
         }
+        return this;
     }
     get reloading() {
         return this._reloading;
@@ -1890,6 +1892,7 @@ class CotomyWindow {
     }
     append(e) {
         this._body.append(e);
+        return this;
     }
     moveNext(focused, shift = false) {
         const selector = "input, a, select, button, textarea";
@@ -1910,6 +1913,7 @@ class CotomyWindow {
     }
     trigger(event, e) {
         window.dispatchEvent(e ?? new Event(event, { bubbles: true }));
+        return this;
     }
     on(event, handle) {
         const events = Array.isArray(event) ? event : [event];
@@ -1919,6 +1923,7 @@ class CotomyWindow {
             this._eventHandlers[eventName].push(handle);
             window.addEventListener(eventName, handle);
         });
+        return this;
     }
     off(event, handle) {
         const events = Array.isArray(event) ? event : [event];
@@ -1940,43 +1945,44 @@ class CotomyWindow {
                 delete this._eventHandlers[eventName];
             }
         });
+        return this;
     }
     load(handle) {
-        this.on("load", handle);
+        return this.on("load", handle);
     }
     ready(handle) {
-        this.on("cotomy:ready", handle);
+        return this.on("cotomy:ready", handle);
     }
     resize(handle) {
         if (handle) {
-            this.on("resize", handle);
+            return this.on("resize", handle);
         }
         else {
-            this.trigger("resize");
+            return this.trigger("resize");
         }
     }
     scroll(handle) {
         if (handle) {
-            this.on("scroll", handle);
+            return this.on("scroll", handle);
         }
         else {
-            this.trigger("scroll");
+            return this.trigger("scroll");
         }
     }
     changeLayout(handle) {
         if (handle) {
-            this.on("cotomy:changelayout", handle);
+            return this.on("cotomy:changelayout", handle);
         }
         else {
-            this.trigger("cotomy:changelayout");
+            return this.trigger("cotomy:changelayout");
         }
     }
     pageshow(handle) {
         if (handle) {
-            this.on("pageshow", handle);
+            return this.on("pageshow", handle);
         }
         else {
-            this.trigger("pageshow");
+            return this.trigger("pageshow");
         }
     }
     get scrollTop() {