@vanduo-oss/framework 1.4.4 → 1.4.6

package/dist/vanduo.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Vanduo Framework — TypeScript declarations for the runtime object.
+ *
+ * These cover the `Vanduo` runtime surface (init / lifecycle / registry).
+ * Per-component option and instance types are intentionally out of scope for
+ * now; component objects are typed loosely as `VanduoComponent`.
+ */
+
+/** A node that can scope component initialization. */
+export type VanduoRoot = Document | Element | DocumentFragment;
+
+/** Options accepted when registering a component. */
+export interface VanduoRegisterOptions {
+  /** Alternate names that resolve to this component. */
+  aliases?: string[];
+}
+
+/**
+ * A registered component. Components self-register via `Vanduo.register` and
+ * typically expose `init` / `destroyAll`. Additional members vary per component
+ * and are intentionally untyped here.
+ */
+export interface VanduoComponent {
+  init?(root?: VanduoRoot): void;
+  destroyAll?(root?: VanduoRoot): void;
+  [key: string]: unknown;
+}
+
+/** The Vanduo framework runtime object (also available as `window.Vanduo`). */
+export interface VanduoStatic {
+  /** Framework version (matches package.json). */
+  readonly version: string;
+  /** Registered components keyed by canonical name. */
+  readonly components: Record<string, VanduoComponent>;
+  /** Alias → canonical-name map. */
+  readonly aliases: Record<string, string>;
+
+  /** Resolve an alias to its canonical component name. */
+  resolveComponentName(name: string): string;
+
+  /**
+   * Initialize the framework. With no argument (or `document`) it waits for DOM
+   * ready and initializes every component; with an element/fragment it
+   * initializes components within that scope immediately.
+   */
+  init(root?: VanduoRoot): void;
+
+  /** Initialize all registered components within `root` (defaults to document). */
+  initComponents(root?: VanduoRoot): void;
+
+  /** Register a component under `name`, optionally with aliases. */
+  register(name: string, component: VanduoComponent, options?: VanduoRegisterOptions): void;
+
+  /** Register an additional alias for an existing component. */
+  registerAlias(alias: string, name: string): void;
+
+  /** Destroy then re-initialize a single component within `root`. */
+  reinit(name: string, root?: VanduoRoot): void;
+
+  /** Destroy component instances within `root` (defaults to document). */
+  destroy(root?: VanduoRoot): void;
+
+  /** Destroy all component instances across the document. */
+  destroyAll(): void;
+
+  /** Get a registered component by (canonical or alias) name, or `null`. */
+  getComponent(name: string): VanduoComponent | null;
+}
+
+export const Vanduo: VanduoStatic;
+export default Vanduo;
+
+declare global {
+  interface Window {
+    Vanduo: VanduoStatic;
+  }
+}

package/dist/vanduo.esm.js

@@ -1,4 +1,4 @@
-/*! Vanduo v1.4.4 | Built: 2026-06-07T19:14:20.877Z | git:781df0d | development */
+/*! Vanduo v1.4.6 | Built: 2026-06-13T10:32:26.875Z | git:82019ff | development */
 
 // js/utils/lifecycle.js
 (function() {
@@ -176,7 +176,7 @@
 // js/vanduo.js
 (function() {
   "use strict";
-  const VANDUO_VERSION = true ? "1.4.4" : "0.0.0-dev";
+  const VANDUO_VERSION = true ? "1.4.6" : "0.0.0-dev";
   const hasOwn = Object.prototype.hasOwnProperty;
   const Vanduo2 = {
     version: VANDUO_VERSION,
@@ -3079,13 +3079,13 @@
      */
     initParallax: function(element) {
       element.dataset.parallaxInitialized = "true";
-      const disableMobile = element.classList.contains("parallax-disable-mobile");
+      const disableMobile = element.classList.contains("vd-parallax-disable-mobile") || element.classList.contains("parallax-disable-mobile");
       if (disableMobile && this.isMobile) {
         return;
       }
       const layers = element.querySelectorAll(".vd-parallax-layer, .vd-parallax-bg");
       const speed = this.getSpeed(element);
-      const direction = element.classList.contains("parallax-horizontal") ? "horizontal" : "vertical";
+      const direction = element.classList.contains("vd-parallax-horizontal") || element.classList.contains("parallax-horizontal") ? "horizontal" : "vertical";
       this.parallaxElements.set(element, {
         layers: Array.from(layers),
         speed,
@@ -3100,9 +3100,9 @@
      * @returns {number} Speed multiplier
      */
     getSpeed: function(element) {
-      if (element.classList.contains("parallax-slow")) {
+      if (element.classList.contains("vd-parallax-slow") || element.classList.contains("parallax-slow")) {
         return 0.5;
-      } else if (element.classList.contains("parallax-fast")) {
+      } else if (element.classList.contains("vd-parallax-fast") || element.classList.contains("parallax-fast")) {
         return 1.5;
       }
       return 1;
@@ -3149,7 +3149,8 @@
       ));
       const offset = (scrollProgress - 0.5) * config.speed * 100;
       config.layers.forEach((layer, _index) => {
-        const layerSpeed = layer.dataset.parallaxSpeed ? parseFloat(layer.dataset.parallaxSpeed) : 1;
+        const layerSpeedAttr = layer.dataset.parallaxSpeed || layer.dataset.speed;
+        const layerSpeed = layerSpeedAttr ? parseFloat(layerSpeedAttr) : 1;
         const layerOffset = offset * layerSpeed;
         if (config.direction === "horizontal") {
           layer.style.transform = `translateX(${layerOffset}px)`;