ziko 0.66.0 → 0.67.0

package/dist/ziko.mjs

@@ -2,7 +2,7 @@
 /*
   Project: ziko.js
   Author: Zakaria Elalaoui
-  Date : Sat Feb 14 2026 15:12:05 GMT+0100 (UTC+01:00)
+  Date : Mon Feb 16 2026 11:34:52 GMT+0000 (UTC)
   Git-Repo : https://github.com/zakarialaoui10/ziko.js
   Git-Wiki : https://github.com/zakarialaoui10/ziko.js/wiki
   Released under MIT License
@@ -2935,7 +2935,6 @@ class ClickAwayEvent extends Event {
 }
 
 function register_click_away_event(element) {
-  console.log(element);
   function handler(e) {
     if (!element.contains(e.target)) {
       const clickAwayEvent = new ClickAwayEvent(e, element);
@@ -3335,9 +3334,56 @@ var StyleMethods = /*#__PURE__*/Object.freeze({
    style: style$1
 });
 
+class EventController {
+  constructor(target, category){
+    this.cache = {
+      category,
+      target,
+      listeners : {},
+      currentEvent : null
+    };
+  }
+  get element(){
+    return this.cache.target.element;
+  }
+  get currentEvent(){
+    return this.cache.currentEvent;
+  }
+  addListener(event, callback){
+    this.cache.listeners[event] = {
+      paused : false,
+      callback : ()=>{
+        if(!this.cache.listeners[event].paused) {
+          this.cache.currentEvent = event;
+          callback.call(this, this);
+        }
+      },
+    };
+    this.element.addEventListener(event, this.cache.listeners[event].callback);
+    return this;
+  }
+  removeListener(event){
+    this.element.removeEventListener(event, this.cache.listeners[event].callback);
+    return this;
+  }
+  pause(event){
+    this.cache.listeners[event].paused = true;
+    return this;
+  }
+  resume(event){
+    this.cache.listeners[event].paused = false;
+    return this;
+  }
+}
+
 let UIElement$1 = class UIElement extends UIElementCore{
   constructor({element, name ='', type='html', render = __Ziko__.__Config__.default.render}={}){
     super();
+    this.exp = {
+      events : {
+
+      }
+    };
     register_to_class(
       this, 
       LifecycleMethods,
@@ -3350,6 +3396,15 @@ let UIElement$1 = class UIElement extends UIElementCore{
 
     if(element)this.init(element, name, type, render);
   }
+  _on(event, callback, {details_setter, category = 'global'} = {}){
+    if(category && !this.exp.events.hasOwnProperty(category)) this.exp.events[category] = new EventController(this, category);
+    const EVENT = this.exp.events[category];
+    EVENT.addListener(event, callback);
+    if(details_setter) details_setter.call(EVENT);
+  }
+  _off(event, category = 'global'){
+    this.exp.events[category].removeListener(event);
+  }
   get element(){
     return this.cache.element;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ziko",
-  "version": "0.66.0",
+  "version": "0.67.0",
   "description": "A versatile JavaScript library offering a rich set of Hyperscript Based UI components, advanced mathematical utilities, interactivity ,animations, client side routing and more ...",
   "keywords": [
     "front-end",
@@ -90,7 +90,7 @@
     "@vitest/coverage-v8": "^4.0.18",
     "cross-env": "^10.1.0",
     "eslint": "^10.0.0",
-    "jsdom": "^28.0.0",
+    "jsdom": "^26.0.0",
     "rollup": "^4.57.1",
     "vitest": "^4.0.18"
   }

package/src/events/custom-events-registry/click-away.js

@@ -7,7 +7,6 @@ class ClickAwayEvent extends Event {
 }
 
 function register_click_away_event(element) {
-  console.log(element)
   function handler(e) {
     if (!element.contains(e.target)) {
       const clickAwayEvent = new ClickAwayEvent(e, element);

package/src/exp-events/controller/index.js

@@ -0,0 +1,41 @@
+export class EventController {
+  constructor(target, category){
+    this.cache = {
+      category,
+      target,
+      listeners : {},
+      currentEvent : null
+    }
+  }
+  get element(){
+    return this.cache.target.element;
+  }
+  get currentEvent(){
+    return this.cache.currentEvent;
+  }
+  addListener(event, callback){
+    this.cache.listeners[event] = {
+      paused : false,
+      callback : ()=>{
+        if(!this.cache.listeners[event].paused) {
+          this.cache.currentEvent = event
+          callback.call(this, this)
+        }
+      },
+    };
+    this.element.addEventListener(event, this.cache.listeners[event].callback);
+    return this;
+  }
+  removeListener(event){
+    this.element.removeEventListener(event, this.cache.listeners[event].callback);
+    return this;
+  }
+  pause(event){
+    this.cache.listeners[event].paused = true;
+    return this;
+  }
+  resume(event){
+    this.cache.listeners[event].paused = false;
+    return this;
+  }
+}

package/src/exp-events/custom-events-registry/click-away.js

@@ -0,0 +1,39 @@
+class ClickAwayEvent extends Event {
+  constructor(originalEvent, targetElement) {
+    super("clickaway", { bubbles: true, cancelable: true });
+    this.originalEvent = originalEvent;
+    this.targetElement = targetElement;
+  }
+}
+
+function register_click_away_event(element) {
+  // console.log(element)
+  function handler(e) {
+    if (!element.contains(e.target)) {
+      const clickAwayEvent = new ClickAwayEvent(e, element);
+      element.dispatchEvent(clickAwayEvent);
+    }
+  }
+
+  globalThis?.document?.addEventListener("click", handler);
+
+  return () => globalThis?.document?.removeEventListener("click", handler);
+  
+}
+
+export{
+    ClickAwayEvent,
+    register_click_away_event
+}
+
+// // Example usage
+// const box = document.querySelector("#my-box");
+
+// const stop = listenClickAway(box);
+
+// box.addEventListener("clickaway", (e) => {
+//   console.log("Clicked outside box!", e);
+// });
+
+// // later, you can stop listening:
+// // stop();

package/src/exp-events/custom-events-registry/index.js

@@ -0,0 +1,3 @@
+export * from './click-away.js'
+export * from './view.js'
+export * from './swipe.js'

package/src/exp-events/custom-events-registry/swipe.js

@@ -0,0 +1,76 @@
+class SwipeEvent extends CustomEvent {
+  constructor(type, detail) {
+    super(type, {
+      detail,
+      bubbles: true,
+      cancelable: true
+    });
+  }
+}
+
+function register_swipe_event(
+  element,
+  threshold = 50,
+  restraint = 100,
+  allowedTime = 500
+) {
+  let startX = 0,
+      startY = 0,
+      startTime = 0,
+      isPointerDown = false;
+
+  function onPointerDown(e) {
+    startX = e.clientX;
+    startY = e.clientY;
+    startTime = performance.now();
+    isPointerDown = true;
+  }
+
+  function onPointerUp(e) {
+    if (!isPointerDown) return;
+    isPointerDown = false;
+
+    const distX = e.clientX - startX;
+    const distY = e.clientY - startY;
+    const elapsed = performance.now() - startTime;
+
+    let direction = null;
+    let eventName = null;
+
+    if (elapsed <= allowedTime) {
+      if (Math.abs(distX) >= threshold && Math.abs(distY) <= restraint) {
+        direction = distX < 0 ? "left" : "right";
+        eventName = "swipe" + direction;
+      } 
+      else if (Math.abs(distY) >= threshold && Math.abs(distX) <= restraint) {
+        direction = distY < 0 ? "up" : "down";
+        eventName = "swipe" + direction;
+      }
+    }
+
+    // Emit event
+    if (eventName) {
+      element.dispatchEvent(
+        new SwipeEvent(eventName, {
+          direction,
+          distX,
+          distY,
+          originalEvent: e
+        })
+      );
+    }
+  }
+
+  element.addEventListener("pointerdown", onPointerDown, { passive: true });
+  element.addEventListener("pointerup", onPointerUp, { passive: true });
+
+  return () => {
+    element.removeEventListener("pointerdown", onPointerDown);
+    element.removeEventListener("pointerup", onPointerUp);
+  };
+}
+
+export {
+  SwipeEvent,
+  register_swipe_event
+};

package/src/exp-events/custom-events-registry/view.js

@@ -0,0 +1,74 @@
+import { throttle } from "../../time/decorators/index.js";
+class ViewEvent extends CustomEvent {
+    constructor(type, detail, { bubbles = true, cancelable = true } = {}) {
+        super(type, { detail, bubbles, cancelable });
+    }
+}
+
+function register_view_event(
+    element,
+    {
+        intersection = true,
+        resize = true,
+        threshold = 0,
+        throttleResize = 100,
+        throttleEnterExit = 0
+    } = {}
+) {
+    let intersectionObserver, resizeObserver;
+    const resizeCallback = entries => {
+        for (let entry of entries) {
+            const { width, height } = entry.contentRect;
+
+            element.dispatchEvent(
+                new ViewEvent("resizeview", {
+                    width,
+                    height,
+                    entry
+                })
+            );
+        }
+    };
+
+    const throttledResize = throttleResize > 0
+        ? throttle(resizeCallback, throttleResize)
+        : resizeCallback;
+
+    const intersectionCallback = entries => {
+        for (let entry of entries) {
+            const type = entry.isIntersecting ? "enterview" : "exitview";
+            element.dispatchEvent(new ViewEvent(type, entry));
+        }
+    };
+
+    const throttledIntersections = throttleEnterExit > 0
+        ? throttle(intersectionCallback, throttleEnterExit)
+        : intersectionCallback;
+
+    if (intersection) {
+        intersectionObserver = new IntersectionObserver(throttledIntersections, { threshold });
+        intersectionObserver.observe(element);
+    }
+
+    if (resize) {
+        resizeObserver = new ResizeObserver(throttledResize);
+        resizeObserver.observe(element);
+    }
+
+    // ---- UNREGISTER ----
+    return () => {
+        if (intersectionObserver) {
+            intersectionObserver.unobserve(element);
+            intersectionObserver.disconnect();
+        }
+        if (resizeObserver) {
+            resizeObserver.unobserve(element);
+            resizeObserver.disconnect();
+        }
+    };
+}
+
+export {
+    ViewEvent,
+    register_view_event
+};

package/src/exp-events/details-setter/index.js

@@ -0,0 +1,4 @@
+export * from './key.js'
+export * from './pointer.js'
+export * from './mouse.js'
+export * from './touch.js'

package/src/exp-events/details-setter/key.js

@@ -0,0 +1,14 @@
+export function key_details_setter(){
+    switch(this.currentEvent){
+        case "keydown" : {
+            this.kd = this.event.key
+        }; break;
+        case "keypress" : {
+            this.kp = this.event.key
+        }; break;
+        case "keyup" : {
+            this.ku = this.event.key
+        }; break;
+
+    }
+}

package/src/exp-events/details-setter/mouse.js

@@ -0,0 +1,35 @@
+export function mouse_details_setter() {
+    const rect = this.targetElement.getBoundingClientRect();
+    const e = this.event;
+    let x = (e.clientX - rect.left) | 0;
+    let y = (e.clientY - rect.top) | 0;
+
+    if(this.cache.useNormalisedCoordinates){
+        const w = this.targetElement.clientWidth;
+        const h = this.targetElement.clientHeight;
+        x = +((x / w) * 2 - 1).toFixed(8);
+        y = +((y / h) * -2 + 1).toFixed(8);
+    }
+
+    switch (this.currentEvent) {
+
+        case "mousedown":
+            this.dx = x;
+            this.dy = y;
+            this.isDown = true;
+            break;
+
+        case "mousemove":
+            this.mx = x;
+            this.my = y;
+            this.isMoving = true;
+            break;
+
+        case "mouserup":
+            this.ux = x;
+            this.uy = y;
+            this.isDown = false;
+            this.isMoving = false;
+            break;
+    }
+}

package/src/exp-events/details-setter/pointer.js

@@ -0,0 +1,35 @@
+export function ptr_details_setter() {
+    const rect = this.targetElement.getBoundingClientRect();
+    const e = this.event;
+    let x = (e.clientX - rect.left) | 0;
+    let y = (e.clientY - rect.top) | 0;
+
+    if(this.cache.useNormalisedCoordinates){
+        const w = this.targetElement.clientWidth;
+        const h = this.targetElement.clientHeight;
+        x = +((x / w) * 2 - 1).toFixed(8);
+        y = +((y / h) * -2 + 1).toFixed(8);
+    }
+    switch (this.currentEvent) {
+
+        case "pointerdown":
+            this.dx = x;
+            this.dy = y;
+            this.isDown = true;
+            break;
+
+        case "pointermove":
+            this.mx = x;
+            this.my = y;
+            this.isMoving = true;
+            break;
+
+        case "pointerup":
+            this.ux = x;
+            this.uy = y;
+            this.isDown = false;
+            this.isMoving = false;
+            break;
+    }
+}
+

package/src/exp-events/details-setter/touch.js

@@ -0,0 +1,37 @@
+export function touch_details_setter() {
+    const e = this.event;
+    const touch = e.touches?.[0] || e.changedTouches?.[0];
+
+    if (!touch) return; // should never happen but safe
+
+    const rect = this.targetElement.getBoundingClientRect();
+    let x = touch.clientX - rect.left;
+    let y = touch.clientY - rect.top;
+
+    if(this.cache.useNormalisedCoordinates){
+        const w = this.targetElement.clientWidth;
+        const h = this.targetElement.clientHeight;
+        x = +((x / w) * 2 - 1).toFixed(8);
+        y = +((y / h) * -2 + 1).toFixed(8);
+    }
+
+    switch (this.currentEvent) {
+        case "touchstart":
+            this.dx = x;
+            this.dy = y;
+            this.isDown = true;
+            break;
+
+        case "touchmove":
+            this.mx = x;
+            this.my = y;
+            this.isMoving = true;
+            break;
+
+        case "touchend":
+            this.ux = x;
+            this.uy = y;
+            this.isDown = false;
+            break;
+    }
+}

package/src/exp-events/index.js

@@ -0,0 +1 @@
+export * from './controller/index.js'

package/src/ui/constructors/UIElement.js

@@ -7,10 +7,19 @@ import {
   IndexingMethods,
   EventsMethodes,
   StyleMethods
-} from "../__methods__/index.js";
+} from "./mixins/index.js";
+
+import {
+  EventController
+} from '../../exp-events/index.js'
 class UIElement extends UIElementCore{
   constructor({element, name ='', type='html', render = __Ziko__.__Config__.default.render}={}){
     super()
+    this.exp = {
+      events : {
+
+      }
+    }
     register_to_class(
       this, 
       LifecycleMethods,
@@ -23,6 +32,15 @@ class UIElement extends UIElementCore{
 
     if(element)this.init(element, name, type, render)
   }
+  _on(event, callback, {details_setter, category = 'global'} = {}){
+    if(category && !this.exp.events.hasOwnProperty(category)) this.exp.events[category] = new EventController(this, category);
+    const EVENT = this.exp.events[category]
+    EVENT.addListener(event, callback);
+    if(details_setter) details_setter.call(EVENT);
+  }
+  _off(event, category = 'global'){
+    this.exp.events[category].removeListener(event)
+  }
   get element(){
     return this.cache.element;
   }

package/src/ui/{__methods__ → constructors/mixins}/dom.js

@@ -1,4 +1,4 @@
-import { text } from "../text/index.js";
+import { text } from "../../text/index.js";
 import { __addItem__ } from "./utils/index.js";
 export function append(...ele) {
   __addItem__.call(this, "append", "push", ...ele);

package/src/ui/{__methods__ → constructors/mixins}/events.js

@@ -1,4 +1,4 @@
-import { EventsMap } from "../../events/events-map/index.js";
+import { EventsMap } from "../../../events/events-map/index.js";
 import {
   bind_pointer_event,
   bind_mouse_event,
@@ -10,9 +10,9 @@ import {
   bind_wheel_event,
   bind_view_event,
   bind_swipe_event
-} from "../../events/binders/index.js";
+} from "../../../events/binders/index.js";
 
-import { bind_custom_event } from "../../events/binders/custom-event.js";
+import { bind_custom_event } from "../../../events/binders/custom-event.js";
 
 const binderMap = {
   ptr: bind_pointer_event,

package/src/ui/{__methods__ → constructors/mixins}/style.js

@@ -1,4 +1,4 @@
-import { isStateGetter } from '../../hooks/use-state.js'
+import { isStateGetter } from '../../../hooks/use-state.js'
 export function style(styles){
     if(!this.element?.style) return this;
     for(let key in styles){

package/src/ui/{__methods__ → constructors/mixins}/utils/index.js

@@ -1,9 +1,9 @@
-import { isStateGetter } from "../../../hooks/use-state.js";
+import { isStateGetter } from "../../../../hooks/use-state.js";
 import { 
   is_camelcase,
   camel2hyphencase
- } from '../../../data/string/index.js'
- import { text } from "../../text/index.js";
+ } from '../../../../data/string/index.js'
+ import { text } from "../../../text/index.js";
 export async function __addItem__(adder, pusher, ...ele) {
   if (this.cache.isFrozzen) {
     console.warn("You can't append new item to frozzen element");