@hortonstudio/main 1.9.20 → 1.9.22

package/src/utils/gsap.ts

@@ -1,198 +0,0 @@
-/**
- * GSAP Global Handler
- *
- * Centralized GSAP detection and error handling.
- * Provides type-safe access to GSAP and ScrollTrigger.
- *
- * Usage:
- *   import { getGsap, hasGsap } from '@utils';
- *
- *   if (hasGsap()) {
- *     const { gsap, ScrollTrigger } = getGsap();
- *     gsap.to(element, { opacity: 1 });
- *   }
- *
- * @version 2.0.0
- */
-
-// Type definitions for externally loaded GSAP
-interface GsapPlugin {
-  create: (config: unknown) => void;
-  getAll: () => unknown[];
-  refresh: () => void;
-}
-
-interface GsapDraggable {
-  create: (target: unknown, vars?: Record<string, unknown>) => unknown[];
-}
-
-interface GsapInstance {
-  to: (target: unknown, vars: Record<string, unknown>) => unknown;
-  from: (target: unknown, vars: Record<string, unknown>) => unknown;
-  set: (target: unknown, vars: Record<string, unknown>) => unknown;
-  timeline: (vars?: Record<string, unknown>) => unknown;
-  registerPlugin: (...plugins: unknown[]) => void;
-}
-
-// Declare global types for GSAP (loaded externally)
-declare global {
-  interface Window {
-    gsap?: GsapInstance;
-    ScrollTrigger?: GsapPlugin;
-    Draggable?: GsapDraggable;
-  }
-}
-
-let hasWarned = false;
-let globalScrollVelocity = 0;
-let globalScrollDirection = 0; // 1 = down, -1 = up, 0 = not scrolling
-let scrollVelocityInitialized = false;
-
-/**
- * Initialize global scroll velocity tracking
- * Call this once to start tracking scroll velocity across the entire page
- */
-export function initScrollVelocityTracking() {
-  if (scrollVelocityInitialized || !hasScrollTrigger()) {
-    return;
-  }
-
-  const gsap = window.gsap!;
-
-  // Track scroll position and smooth velocity
-  let lastScrollY = window.scrollY;
-  let lastTime = performance.now();
-  let targetVelocity = 0;
-  let currentVelocity = 0;
-
-  // Update target velocity and direction on scroll
-  window.ScrollTrigger!.create({
-    onUpdate: () => {
-      const currentScrollY = window.scrollY;
-      const currentTime = performance.now();
-      const deltaY = currentScrollY - lastScrollY;
-      const deltaTime = currentTime - lastTime;
-
-      // Update scroll direction
-      if (deltaY > 0) {
-        globalScrollDirection = 1; // Scrolling down
-      } else if (deltaY < 0) {
-        globalScrollDirection = -1; // Scrolling up
-      }
-
-      // Calculate velocity in pixels per second (framerate-independent)
-      // Avoid division by zero
-      if (deltaTime > 0) {
-        targetVelocity = (Math.abs(deltaY) / deltaTime) * 1000; // Convert to pixels/second
-      }
-
-      lastScrollY = currentScrollY;
-      lastTime = currentTime;
-    },
-  });
-
-  // Smoothly lerp current velocity to target velocity every frame
-  gsap.ticker.add(() => {
-    // Lerp factor: lower = smoother (0.08 for buttery smooth)
-    const lerpFactor = 0.08;
-
-    // Interpolate current velocity towards target
-    currentVelocity += (targetVelocity - currentVelocity) * lerpFactor;
-
-    // Decay target velocity (simulates friction) - slower decay for smoothness
-    targetVelocity *= 0.95;
-
-    // Snap to zero when very small
-    if (Math.abs(currentVelocity) < 0.1) {
-      currentVelocity = 0;
-    }
-    if (Math.abs(targetVelocity) < 0.1) {
-      targetVelocity = 0;
-    }
-
-    // Update global velocity
-    globalScrollVelocity = currentVelocity;
-  });
-
-  scrollVelocityInitialized = true;
-}
-
-/**
- * Get current scroll velocity
- * @returns Current scroll velocity (pixels per second)
- */
-export function getScrollVelocity(): number {
-  return globalScrollVelocity;
-}
-
-/**
- * Get current scroll direction
- * @returns 1 for down, -1 for up, 0 for not scrolling
- */
-export function getScrollDirection(): number {
-  return globalScrollDirection;
-}
-
-/**
- * Check if GSAP is available
- */
-export function hasGsap(): boolean {
-  return typeof window.gsap !== 'undefined';
-}
-
-/**
- * Check if ScrollTrigger is available
- */
-export function hasScrollTrigger(): boolean {
-  return typeof window.ScrollTrigger !== 'undefined';
-}
-
-/**
- * Check if Draggable is available
- */
-export function hasDraggable(): boolean {
-  return typeof window.Draggable !== 'undefined';
-}
-
-/**
- * Get GSAP instance with type safety
- * @param moduleName - Name of the module requesting GSAP (for logging)
- * @param required - Whether GSAP is required (default: true)
- * @returns GSAP instance or null if not available
- */
-export function getGsap(moduleName?: string, required: boolean = true) {
-  if (!hasGsap()) {
-    if (required && !hasWarned) {
-      console.warn(
-        '[gsap] GSAP library not detected. Some animations will be skipped. ' +
-          'Add GSAP to your project: https://greensock.com/docs/v3/Installation'
-      );
-      hasWarned = true;
-    } else if (moduleName && !hasWarned) {
-      console.warn(`[${moduleName}] GSAP not available, module will use fallback behavior`);
-      hasWarned = true;
-    }
-    return null;
-  }
-
-  return {
-    gsap: window.gsap!,
-    ScrollTrigger: window.ScrollTrigger,
-    Draggable: window.Draggable,
-  };
-}
-
-/**
- * Reset warning state (useful for testing)
- */
-export function resetGsapWarning() {
-  hasWarned = false;
-}
-
-/**
- * Check if user prefers reduced motion
- * @returns true if user prefers reduced motion
- */
-export function prefersReducedMotion(): boolean {
-  return window.matchMedia('(prefers-reduced-motion: reduce)').matches;
-}

package/src/utils/heightAnimator.ts

@@ -1,130 +0,0 @@
-/**
- * Global height animation utility with singleton pattern
- * Handles GSAP height animations with customizable duration and easing
- *
- * Uses config from @config for all attribute names
- * Supports per-element customization via attributes
- *
- * @version 2.0.0
- */
-import config from '@config';
-import { getGsap, prefersReducedMotion } from './gsap.ts';
-
-class HeightAnimator {
-  #activeAnimations = new Map();
-
-  /**
-   * Animate element height to open or closed state
-   * @param {HTMLElement} element - Container element (may contain height target)
-   * @param {boolean} isOpen - True to open (height: auto), false to close (height: 0)
-   * @param {Object} options - Animation options
-   * @param {number} options.duration - Duration in milliseconds (default: 300)
-   * @param {string} options.ease - GSAP easing function (default: 'power2.inOut')
-   */
-  async animate(element, isOpen, options = {}) {
-    const gsapLib = getGsap('heightAnimator');
-    if (!gsapLib) return;
-
-    const { gsap } = gsapLib;
-
-    const heightAttr = config._global.attributes.height;
-    const heightValue = config._global.attributes.heightValue;
-    const durationAttr = config._global.attributes.heightDuration;
-    const easeAttr = config._global.attributes.heightEase;
-
-    // Check for custom height target element
-    const heightTarget =
-      element.hasAttribute?.(heightAttr) && element.getAttribute(heightAttr) === heightValue
-        ? element
-        : element.querySelector?.(`[${heightAttr}="${heightValue}"]`) || element;
-
-    // Cancel existing animation on this element
-    const existingAnim = this.#activeAnimations.get(heightTarget);
-    if (existingAnim) {
-      existingAnim.kill();
-      this.#activeAnimations.delete(heightTarget);
-    }
-
-    // Get attributes - check both the target AND its parent wrapper
-    let durationValue = heightTarget.getAttribute(durationAttr);
-    let easeValue = heightTarget.getAttribute(easeAttr);
-
-    // If not found on target, check parent wrapper
-    if (!durationValue && heightTarget.parentElement) {
-      durationValue = heightTarget.parentElement.getAttribute(durationAttr);
-    }
-    if (!easeValue && heightTarget.parentElement) {
-      easeValue = heightTarget.parentElement.getAttribute(easeAttr);
-    }
-
-    // Fallback chain: attribute > options > default
-    let duration = durationValue
-      ? parseInt(durationValue, 10) / 1000
-      : (options.duration || 300) / 1000;
-
-    // Force instant updates if user prefers reduced motion
-    if (prefersReducedMotion()) {
-      duration = 0;
-    }
-
-    const ease = easeValue || options.ease || 'power2.inOut';
-
-    // Create animation
-    const animation = gsap.to(heightTarget, {
-      height: isOpen ? 'auto' : 0,
-      duration: duration,
-      ease: ease,
-    });
-
-    // Track active animation
-    this.#activeAnimations.set(heightTarget, animation);
-
-    // Wait for animation to complete
-    try {
-      await animation.then();
-    } finally {
-      this.#activeAnimations.delete(heightTarget);
-    }
-  }
-
-  /**
-   * Set element height immediately without animation (for initial state)
-   * @param {HTMLElement} element - Container element (may contain height target)
-   * @param {boolean} isOpen - True for auto height, false for 0
-   */
-  setHeight(element, isOpen) {
-    const gsapLib = getGsap('heightAnimator');
-    if (!gsapLib) return;
-
-    const { gsap } = gsapLib;
-
-    const heightAttr = config._global.attributes.height;
-    const heightValue = config._global.attributes.heightValue;
-
-    // Check for custom height target element
-    const heightTarget =
-      element.hasAttribute?.(heightAttr) && element.getAttribute(heightAttr) === heightValue
-        ? element
-        : element.querySelector?.(`[${heightAttr}="${heightValue}"]`) || element;
-
-    // Set immediately without animation
-    gsap.set(heightTarget, {
-      height: isOpen ? 'auto' : 0,
-    });
-  }
-
-  /**
-   * Cancel all active animations (for cleanup)
-   */
-  cancelAll() {
-    this.#activeAnimations.forEach((anim) => anim.kill());
-    this.#activeAnimations.clear();
-  }
-}
-
-// Export singleton instance
-export const heightAnimator = new HeightAnimator();
-
-// Export bound methods for convenience
-export const animateHeight = heightAnimator.animate.bind(heightAnimator);
-export const setHeight = heightAnimator.setHeight.bind(heightAnimator);

package/src/utils/modalManager.ts

@@ -1,150 +0,0 @@
-/**
- * Global modal manager with extensible hooks
- * Handles body classes and allows custom callbacks for modal open/close
- * Uses reference counting to support multiple modals open simultaneously
- *
- * Class names configured via @config for easy customization
- *
- * Usage (internal):
- *   import { openModal, closeModal } from '@utils/modalManager.js';
- *   openModal();  // Register modal as open
- *   closeModal(); // Register modal as closed
- *
- * Usage (external):
- *   window.HS.modal.open();
- *   window.HS.modal.close();
- *   window.HS.modal.onOpen(() => window.lenis?.stop());
- *   window.HS.modal.onClose(() => window.lenis?.start());
- *
- * @version 2.0.0
- */
-import config from '@config';
-
-let activeModalCount = 0;
-const openCallbacks = [];
-const closeCallbacks = [];
-
-/**
- * Register a callback to run when first modal opens
- * @param {Function} callback - Function to run on modal open
- * @returns {Function} Unregister function
- */
-export function onModalOpen(callback) {
-  if (typeof callback !== 'function') {
-    console.warn('[modalManager] onModalOpen requires a function');
-    return () => {};
-  }
-
-  openCallbacks.push(callback);
-
-  // Return unregister function
-  return () => {
-    const index = openCallbacks.indexOf(callback);
-    if (index > -1) openCallbacks.splice(index, 1);
-  };
-}
-
-/**
- * Register a callback to run when last modal closes
- * @param {Function} callback - Function to run on modal close
- * @returns {Function} Unregister function
- */
-export function onModalClose(callback) {
-  if (typeof callback !== 'function') {
-    console.warn('[modalManager] onModalClose requires a function');
-    return () => {};
-  }
-
-  closeCallbacks.push(callback);
-
-  // Return unregister function
-  return () => {
-    const index = closeCallbacks.indexOf(callback);
-    if (index > -1) closeCallbacks.splice(index, 1);
-  };
-}
-
-/**
- * Register a modal as open
- * Increments modal count and applies body classes when first modal opens
- */
-export function openModal() {
-  activeModalCount++;
-
-  // Only apply effects when first modal opens
-  if (activeModalCount === 1) {
-    const modalOpenClass = config._global.classes.modalOpen;
-    const overflowHiddenClass = config._global.classes.overflowHidden;
-
-    document.body.classList.add(overflowHiddenClass, modalOpenClass);
-
-    // Run all registered open callbacks
-    openCallbacks.forEach((callback) => {
-      try {
-        callback();
-      } catch (error) {
-        console.error('[modalManager] Error in open callback:', error);
-      }
-    });
-  }
-}
-
-/**
- * Register a modal as closed
- * Decrements modal count and removes body classes when last modal closes
- */
-export function closeModal() {
-  activeModalCount--;
-
-  // Only remove effects when last modal closes
-  if (activeModalCount === 0) {
-    const modalOpenClass = config._global.classes.modalOpen;
-    const overflowHiddenClass = config._global.classes.overflowHidden;
-
-    document.body.classList.remove(overflowHiddenClass, modalOpenClass);
-
-    // Run all registered close callbacks
-    closeCallbacks.forEach((callback) => {
-      try {
-        callback();
-      } catch (error) {
-        console.error('[modalManager] Error in close callback:', error);
-      }
-    });
-  }
-
-  // Safety: prevent negative count
-  if (activeModalCount < 0) {
-    console.warn('[modalManager] Modal count went negative, resetting to 0');
-    activeModalCount = 0;
-  }
-}
-
-/**
- * Get current modal count (for debugging)
- * @returns {number} Number of active modals
- */
-export function getActiveModalCount() {
-  return activeModalCount;
-}
-
-/**
- * Check if any modals are currently open
- * @returns {boolean} True if at least one modal is open
- */
-export function isModalOpen() {
-  return activeModalCount > 0;
-}
-
-// Expose globally for external scripts
-if (typeof window !== 'undefined') {
-  window.HS = window.HS || {};
-  window.HS.modal = {
-    open: openModal,
-    close: closeModal,
-    getCount: getActiveModalCount,
-    isOpen: isModalOpen,
-    onOpen: onModalOpen,
-    onClose: onModalClose,
-  };
-}

package/src/utils.ts

@@ -1,54 +0,0 @@
-/**
- * Centralized utils export
- *
- * Barrel export for all utility functions to enable cleaner imports.
- * Instead of multiple relative imports, modules can import from a single source.
- *
- * Usage:
- *   import { getSelector, animateHeight, openModal } from '../../src/utils.js';
- *
- * @version 2.0.0
- */
-
-// Attribute selector utilities
-export {
-  getSelector,
-  querySelectorAll,
-  querySelector,
-  checkDeprecated,
-} from './utils/attributeSelector.ts';
-
-// Height animation utilities
-export { animateHeight, setHeight } from './utils/heightAnimator.ts';
-
-// Modal manager utilities
-export {
-  openModal,
-  closeModal,
-  onModalOpen,
-  onModalClose,
-  getActiveModalCount,
-  isModalOpen,
-} from './utils/modalManager.ts';
-
-// Import config to extract globalConfig
-import config from '@config';
-
-// Export globalConfig from master config
-export const globalConfig = config._global;
-
-// CSS variables utility (default export becomes named export)
-export { default as cssVariables } from './utils/cssVariables.ts';
-
-// GSAP utilities
-export {
-  getGsap,
-  hasGsap,
-  hasScrollTrigger,
-  hasDraggable,
-  resetGsapWarning,
-  prefersReducedMotion,
-  initScrollVelocityTracking,
-  getScrollVelocity,
-  getScrollDirection,
-} from './utils/gsap.ts';

package/tsconfig.json

@@ -1,24 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "lib": ["ES2020", "DOM", "DOM.Iterable"],
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "allowImportingTsExtensions": true,
-    "noEmit": true,
-    "strict": false,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "forceConsistentCasingInFileNames": true,
-    "paths": {
-      "@utils": ["./src/utils.ts"],
-      "@utils/*": ["./src/utils/*"],
-      "@config": ["./src/config.ts"],
-      "@modules/*": ["./src/modules/*"]
-    }
-  },
-  "include": ["src/**/*", "index.ts", "*.d.ts"],
-  "exclude": ["node_modules", "dist"]
-}

package/vite.config.js

@@ -1,45 +0,0 @@
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import compression from 'vite-plugin-compression';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-export default {
-  server: {
-    cors: true,
-  },
-  resolve: {
-    alias: {
-      '@utils/': resolve(__dirname, './src/utils/'),
-      '@utils': resolve(__dirname, './src/utils.ts'),
-      '@config': resolve(__dirname, './src/config.ts'),
-      '@modules/': resolve(__dirname, './src/modules/'),
-    },
-  },
-  plugins: [compression({ algorithm: 'brotli' }), compression({ algorithm: 'gzip' })],
-  build: {
-    outDir: 'dist',
-    sourcemap: true,
-    rollupOptions: {
-      input: {
-        main: resolve(__dirname, './index.ts'),
-        bootstrap: resolve(__dirname, './public/bootstrap.js'),
-      },
-      output: {
-        entryFileNames: '[name].js',
-        format: 'es',
-      },
-    },
-    minify: 'terser',
-    terserOptions: {
-      compress: {
-        drop_console: false,
-        drop_debugger: true,
-      },
-      format: {
-        comments: false,
-      },
-    },
-  },
-};