@vanduo-oss/framework 1.3.2 → 1.3.4

package/dist/vanduo.esm.js

@@ -1,4 +1,4 @@
-/*! Vanduo v1.3.2 | Built: 2026-04-06T19:04:41.601Z | git:8e08b38 | development */
+/*! Vanduo v1.3.4 | Built: 2026-04-14T21:21:55.517Z | git:73e3db5 | development */
 
 // js/utils/lifecycle.js
 (function() {
@@ -107,7 +107,7 @@
 // js/vanduo.js
 (function() {
   "use strict";
-  const VANDUO_VERSION = true ? "1.3.2" : "0.0.0-dev";
+  const VANDUO_VERSION = true ? "1.3.4" : "0.0.0-dev";
   const Vanduo2 = {
     version: VANDUO_VERSION,
     components: {},
@@ -2157,6 +2157,31 @@
         this.initNavbar(navbar);
       });
     },
+    /**
+     * Initialize scroll-aware glass/transparent behaviour for a navbar.
+     * Adds/removes `.vd-navbar-scrolled` when the page scrolls past a threshold.
+     * Threshold: `data-scroll-threshold` attribute (px) or the navbar's own height.
+     * @param {HTMLElement} navbar - Navbar element
+     * @returns {Function|null} Cleanup function, or null if not applicable
+     */
+    initScrollWatcher: function(navbar) {
+      const isGlass = navbar.classList.contains("vd-navbar-glass");
+      const isTransparent = navbar.classList.contains("vd-navbar-transparent");
+      if (!isGlass && !isTransparent) {
+        return null;
+      }
+      const getThreshold = () => {
+        const attr = parseInt(navbar.dataset.scrollThreshold, 10);
+        return isNaN(attr) ? navbar.offsetHeight || 60 : attr;
+      };
+      const onScroll = () => {
+        const scrolled = window.scrollY > getThreshold();
+        navbar.classList.toggle("vd-navbar-scrolled", scrolled);
+      };
+      onScroll();
+      window.addEventListener("scroll", onScroll, { passive: true });
+      return () => window.removeEventListener("scroll", onScroll);
+    },
     /**
      * Initialize a single navbar
      * @param {HTMLElement} navbar - Navbar element
@@ -2165,10 +2190,17 @@
       const toggle = navbar.querySelector(".vd-navbar-toggle, .vd-navbar-burger");
       const menu = navbar.querySelector(".vd-navbar-menu");
       const overlay = navbar.querySelector(".vd-navbar-overlay") || this.createOverlay(navbar);
+      const cleanupFunctions = [];
+      const scrollWatcherCleanup = this.initScrollWatcher(navbar);
+      if (scrollWatcherCleanup) {
+        cleanupFunctions.push(scrollWatcherCleanup);
+      }
       if (!toggle || !menu) {
+        if (cleanupFunctions.length) {
+          this.instances.set(navbar, { toggle: null, menu: null, overlay: null, cleanup: cleanupFunctions });
+        }
         return;
       }
-      const cleanupFunctions = [];
       const toggleClickHandler = (e) => {
         e.preventDefault();
         e.stopPropagation();
@@ -3806,6 +3838,7 @@
     loadPreferences: function() {
       this.state.theme = this.getStorageValue(this.STORAGE_KEYS.THEME, this.DEFAULTS.THEME);
       this.state.primary = this.getStorageValue(this.STORAGE_KEYS.PRIMARY, this.getDefaultPrimary(this.state.theme));
+      this._normalizeDefaultPrimaryIfStaleWithStoredTheme();
       this.state.neutral = this.getStorageValue(this.STORAGE_KEYS.NEUTRAL, this.DEFAULTS.NEUTRAL);
       this.state.radius = this.getStorageValue(this.STORAGE_KEYS.RADIUS, this.DEFAULTS.RADIUS);
       this.state.font = this.getStorageValue(this.STORAGE_KEYS.FONT, this.DEFAULTS.FONT);
@@ -3891,12 +3924,10 @@
         mode = this.DEFAULTS.THEME;
       }
       this._isApplying = true;
-      const currentMode = this.state.theme;
-      const oldDefault = this.getDefaultPrimary(currentMode);
-      if (this.state.primary === oldDefault) {
-        const newDefault = this.getDefaultPrimary(mode);
-        if (newDefault !== this.state.primary) {
-          this.applyPrimary(newDefault);
+      if (this.isUsingDefaultPrimary()) {
+        const expected = this.getDefaultPrimary(mode);
+        if (this.state.primary !== expected) {
+          this.applyPrimary(expected);
         }
       }
       this.state.theme = mode;
@@ -4138,6 +4169,20 @@
     isUsingDefaultPrimary: function() {
       return this.state.primary === this.DEFAULTS.PRIMARY_LIGHT || this.state.primary === this.DEFAULTS.PRIMARY_DARK;
     },
+    /**
+     * When primary is still one of the auto-default palette keys (black/amber) but
+     * localStorage was written under a different theme (or OS changed in system mode),
+     * align in-memory state before applyAllPreferences runs — avoids amber+light / black+dark drift.
+     */
+    _normalizeDefaultPrimaryIfStaleWithStoredTheme: function() {
+      if (!this.isUsingDefaultPrimary()) {
+        return;
+      }
+      const expected = this.getDefaultPrimary(this.state.theme);
+      if (this.state.primary !== expected) {
+        this.state.primary = expected;
+      }
+    },
     bindEvents: function() {
       if (this.elements.trigger) {
         this.addListener(this.elements.trigger, "click", (e) => {
@@ -4376,6 +4421,9 @@
       this._onMediaChange = (_e) => {
         if (this.state.preference === "system") {
           this.applyTheme();
+          if (window.ThemeCustomizer && typeof window.ThemeCustomizer.applyTheme === "function" && !window.ThemeCustomizer._isApplying) {
+            window.ThemeCustomizer.applyTheme("system");
+          }
         }
       };
       this._mediaQuery.addEventListener("change", this._onMediaChange);
@@ -5607,6 +5655,8 @@
     touchState: null,
     // Feedback element
     feedbackElement: null,
+    // Shared selector used by init and touch reorder
+    containerSelector: ".vd-draggable-container, .vd-draggable-container-vertical",
     /**
      * Initialize draggable components
      */
@@ -5618,7 +5668,7 @@
         }
         this.initDraggable(element);
       });
-      const containers = document.querySelectorAll(".vd-draggable-container, .vd-draggable-container-vertical");
+      const containers = document.querySelectorAll(this.containerSelector);
       containers.forEach((container) => {
         if (!this.instances.has(container)) {
           this.initContainer(container);
@@ -5862,10 +5912,16 @@
      */
     handleTouchStart: function(e, element) {
       const touch = e.touches[0];
+      const rect = element.getBoundingClientRect();
       this.touchState = {
         element,
         startX: touch.clientX,
         startY: touch.clientY,
+        lastX: touch.clientX,
+        lastY: touch.clientY,
+        // Keep preview anchored to the original grab point.
+        offsetX: touch.clientX - rect.left,
+        offsetY: touch.clientY - rect.top,
         startTime: Date.now(),
         isDragging: false
       };
@@ -5878,6 +5934,8 @@
     handleTouchMove: function(e, element) {
       if (!this.touchState) return;
       const touch = e.touches[0];
+      this.touchState.lastX = touch.clientX;
+      this.touchState.lastY = touch.clientY;
       const deltaX = touch.clientX - this.touchState.startX;
       const deltaY = touch.clientY - this.touchState.startY;
       if (Math.abs(deltaX) > 10 || Math.abs(deltaY) > 10) {
@@ -5890,7 +5948,10 @@
             element,
             initialPosition: { x: this.touchState.startX, y: this.touchState.startY },
             initialBounds: element.getBoundingClientRect(),
-            data: this.getData(element)
+            data: this.getData(element),
+            // Preserve where inside the element the drag started for accurate ghost positioning.
+            offsetX: this.touchState.offsetX,
+            offsetY: this.touchState.offsetY
           };
           element.dispatchEvent(new CustomEvent("draggable:start", {
             bubbles: true,
@@ -5912,7 +5973,8 @@
               delta: { x: deltaX, y: deltaY }
             }
           }));
-          const container = element.closest(".vd-draggable-container");
+          this.updateTouchDropZone(touch.clientX, touch.clientY);
+          const container = element.closest(this.containerSelector);
           if (container && container.contains(element)) {
             this.handleReorder(container, element, touch.clientX, touch.clientY);
           }
@@ -5927,6 +5989,17 @@
     handleTouchEnd: function(e, element) {
       if (this.touchState && this.touchState.isDragging) {
         if (e.cancelable) e.preventDefault();
+        const endTouch = e.changedTouches?.[0];
+        const endPosition = {
+          x: endTouch?.clientX ?? this.touchState.lastX ?? this.touchState.startX,
+          y: endTouch?.clientY ?? this.touchState.lastY ?? this.touchState.startY
+        };
+        const dropZone = this.resolveDropZoneAtPoint(endPosition.x, endPosition.y) || this.touchState.overZone;
+        if (dropZone) {
+          this.dispatchDrop(dropZone, endPosition);
+        } else if (this.touchState.overZone) {
+          this.touchState.overZone.classList.remove("is-drag-over");
+        }
         element.classList.remove("is-dragging");
         element.classList.add("is-dropped");
         element.setAttribute("aria-grabbed", "false");
@@ -5934,7 +6007,6 @@
         if (this.feedbackElement) {
           this.feedbackElement.classList.add("hidden");
         }
-        const endTouch = e.changedTouches[0];
         const data = this.currentDrag?.data || this.getData(element);
         const startX = this.touchState?.startX || 0;
         const startY = this.touchState?.startY || 0;
@@ -5943,10 +6015,10 @@
           detail: {
             element,
             data,
-            position: { x: endTouch.clientX, y: endTouch.clientY },
+            position: endPosition,
             delta: {
-              x: endTouch.clientX - startX,
-              y: endTouch.clientY - startY
+              x: endPosition.x - startX,
+              y: endPosition.y - startY
             }
           }
         }));
@@ -5987,6 +6059,58 @@
      */
     handleDrop: function(e, zone) {
       e.preventDefault();
+      this.dispatchDrop(zone, { x: e.clientX, y: e.clientY });
+    },
+    /**
+     * Resolve a drop zone from viewport coordinates
+     * @param {number} x
+     * @param {number} y
+     * @returns {HTMLElement|null}
+     */
+    resolveDropZoneAtPoint: function(x, y) {
+      if (!Number.isFinite(x) || !Number.isFinite(y)) return null;
+      if (typeof document.elementsFromPoint === "function") {
+        const stacked = document.elementsFromPoint(x, y);
+        for (const element of stacked) {
+          const zone = element.closest(".vd-drop-zone");
+          if (zone) return zone;
+        }
+      }
+      const target = document.elementFromPoint(x, y);
+      const targetZone = target ? target.closest(".vd-drop-zone") : null;
+      if (targetZone) return targetZone;
+      const zones = document.querySelectorAll(".vd-drop-zone");
+      for (const zone of zones) {
+        const rect = zone.getBoundingClientRect();
+        if (x >= rect.left && x <= rect.right && y >= rect.top && y <= rect.bottom) {
+          return zone;
+        }
+      }
+      return null;
+    },
+    /**
+     * Track and update active drop-zone hover state on touch devices
+     * @param {number} x
+     * @param {number} y
+     */
+    updateTouchDropZone: function(x, y) {
+      if (!this.touchState) return;
+      const nextZone = this.resolveDropZoneAtPoint(x, y);
+      const prevZone = this.touchState.overZone || null;
+      if (prevZone && prevZone !== nextZone) {
+        prevZone.classList.remove("is-drag-over");
+      }
+      if (nextZone && nextZone !== prevZone) {
+        nextZone.classList.add("is-drag-over");
+      }
+      this.touchState.overZone = nextZone || null;
+    },
+    /**
+     * Dispatch a normalized drop event for mouse and touch flows
+     * @param {HTMLElement} zone
+     * @param {{x:number, y:number}} position
+     */
+    dispatchDrop: function(zone, position) {
       zone.classList.remove("is-drag-over");
       zone.dispatchEvent(new CustomEvent("draggable:drop", {
         bubbles: true,
@@ -5994,7 +6118,7 @@
           zone,
           element: this.currentDrag?.element,
           data: this.currentDrag?.data,
-          position: { x: e.clientX, y: e.clientY }
+          position
         }
       }));
     },
@@ -6095,9 +6219,11 @@
       this.feedbackElement.innerHTML = "";
       const clone = this.currentDrag.element.cloneNode(true);
       this.feedbackElement.appendChild(clone);
+      const offsetX = this.currentDrag.offsetX ?? 20;
+      const offsetY = this.currentDrag.offsetY ?? 20;
       Object.assign(this.feedbackElement.style, {
-        left: x - 20 + "px",
-        top: y - 20 + "px",
+        left: x - offsetX + "px",
+        top: y - offsetY + "px",
         width: rect.width + "px",
         height: rect.height + "px"
       });
@@ -6385,6 +6511,67 @@
   window.VanduoLazyLoad = VanduoLazyLoad;
 })();
 
+// js/components/glass.js
+(function() {
+  "use strict";
+  const GlassScroll = {
+    /** @type {Map<Element, IntersectionObserver>} */
+    observers: /* @__PURE__ */ new Map(),
+    init: function() {
+      document.querySelectorAll("[data-glass-scroll]").forEach((el) => {
+        if (this.observers.has(el)) return;
+        this.initElement(el);
+      });
+    },
+    /**
+     * Wire up a single scroll-activated glass element.
+     * @param {HTMLElement} el
+     */
+    initElement: function(el) {
+      const sentinelSelector = el.dataset.glassSentinel;
+      let sentinel;
+      if (sentinelSelector) {
+        sentinel = document.querySelector(sentinelSelector);
+      }
+      if (!sentinel) {
+        sentinel = el.previousElementSibling;
+      }
+      if (!sentinel) {
+        el.classList.add("is-glass-active");
+        return;
+      }
+      const observer = new IntersectionObserver(
+        (entries) => {
+          entries.forEach((entry) => {
+            el.classList.toggle("is-glass-active", !entry.isIntersecting);
+          });
+        },
+        { threshold: 0, rootMargin: "0px" }
+      );
+      observer.observe(sentinel);
+      this.observers.set(el, observer);
+    },
+    /**
+     * Disconnect and remove a single element's observer.
+     * @param {HTMLElement} el
+     */
+    destroy: function(el) {
+      const observer = this.observers.get(el);
+      if (observer) {
+        observer.disconnect();
+        this.observers.delete(el);
+      }
+    },
+    destroyAll: function() {
+      this.observers.forEach((observer, el) => this.destroy(el));
+    }
+  };
+  if (typeof window.Vanduo !== "undefined") {
+    window.Vanduo.register("glassScroll", GlassScroll);
+  }
+  window.VanduoGlassScroll = GlassScroll;
+})();
+
 // js/components/flow.js
 (function() {
   "use strict";