@coherent.js/client 1.0.0-rc.2 → 1.0.0-rc.3

package/dist/router.js

@@ -0,0 +1,386 @@
+// src/router.js
+function createRouter(options = {}) {
+  const opts = {
+    mode: options.mode || "history",
+    base: options.base || "/",
+    ...options
+  };
+  opts.prefetch = {
+    enabled: false,
+    strategy: "hover",
+    delay: 100,
+    maxConcurrent: 3,
+    priority: {
+      critical: 100,
+      high: 50,
+      normal: 0,
+      low: -50
+    },
+    ...options.prefetch || {}
+  };
+  opts.transitions = {
+    enabled: false,
+    default: {
+      enter: "fade-in",
+      leave: "fade-out",
+      duration: 300
+    },
+    routes: {},
+    onStart: null,
+    onComplete: null,
+    ...options.transitions || {}
+  };
+  opts.codeSplitting = {
+    enabled: false,
+    strategy: "route",
+    chunkNaming: "[name]-[hash]",
+    preload: [],
+    onLoad: null,
+    ...options.codeSplitting || {}
+  };
+  opts.scrollBehavior = {
+    enabled: true,
+    behavior: "smooth",
+    position: "top",
+    delay: 0,
+    savePosition: true,
+    custom: null,
+    ...options.scrollBehavior || {}
+  };
+  const state = {
+    routes: /* @__PURE__ */ new Map(),
+    currentRoute: null,
+    history: [],
+    prefetchQueue: [],
+    prefetching: /* @__PURE__ */ new Set(),
+    loadedChunks: /* @__PURE__ */ new Map(),
+    savedPositions: /* @__PURE__ */ new Map(),
+    transitionState: null
+  };
+  const stats = {
+    navigations: 0,
+    prefetches: 0,
+    transitionsCompleted: 0,
+    chunksLoaded: 0,
+    scrollRestores: 0
+  };
+  function addRoute(path, config) {
+    state.routes.set(path, {
+      path,
+      component: config.component,
+      meta: config.meta || {},
+      beforeEnter: config.beforeEnter,
+      beforeLeave: config.beforeLeave,
+      priority: config.priority || opts.prefetch.priority.normal,
+      transition: config.transition || opts.transitions.default,
+      lazy: typeof config.component === "function",
+      loaded: !config.component || typeof config.component !== "function",
+      chunk: null
+    });
+    if (opts.codeSplitting.enabled && Array.isArray(opts.codeSplitting.preload) && opts.codeSplitting.preload.includes(path)) {
+      loadRoute(path);
+    }
+  }
+  async function loadRoute(path) {
+    const route = state.routes.get(path);
+    if (!route) {
+      throw new Error(`Route not found: ${path}`);
+    }
+    if (route.loaded) {
+      return route.component;
+    }
+    try {
+      const startTime = performance.now();
+      const component = await route.component();
+      route.component = component;
+      route.loaded = true;
+      route.chunk = opts.codeSplitting.chunkNaming.replace("[name]", path.replace(/\//g, "-")).replace("[hash]", generateHash(path));
+      const loadTime = performance.now() - startTime;
+      state.loadedChunks.set(path, {
+        path,
+        loadTime,
+        timestamp: Date.now()
+      });
+      stats.chunksLoaded++;
+      if (opts.codeSplitting.onLoad) {
+        opts.codeSplitting.onLoad(path, component, loadTime);
+      }
+      return component;
+    } catch (error) {
+      route.loaded = false;
+      throw new Error(`Failed to load route ${path}: ${error.message}`);
+    }
+  }
+  async function prefetchRoute(path, priority = opts.prefetch.priority.normal) {
+    if (!opts.prefetch.enabled) return;
+    const route = state.routes.get(path);
+    if (!route || route.loaded || state.prefetching.has(path)) {
+      return;
+    }
+    state.prefetchQueue.push({ path, priority });
+    state.prefetchQueue.sort((a, b) => b.priority - a.priority);
+    processPrefetchQueue();
+  }
+  async function processPrefetchQueue() {
+    if (state.prefetching.size >= opts.prefetch.maxConcurrent) {
+      return;
+    }
+    const item = state.prefetchQueue.shift();
+    if (!item) return;
+    const { path } = item;
+    state.prefetching.add(path);
+    try {
+      await loadRoute(path);
+      stats.prefetches++;
+    } catch (error) {
+      console.warn(`Prefetch failed for ${path}:`, error);
+    } finally {
+      state.prefetching.delete(path);
+      if (state.prefetchQueue.length > 0) {
+        processPrefetchQueue();
+      }
+    }
+  }
+  function setupPrefetchStrategy(element, path) {
+    if (!opts.prefetch.enabled || !element) return;
+    if (opts.prefetch.strategy === "hover") {
+      let timeoutId;
+      element.addEventListener("mouseenter", () => {
+        timeoutId = setTimeout(() => {
+          prefetchRoute(path);
+        }, opts.prefetch.delay);
+      });
+      element.addEventListener("mouseleave", () => {
+        clearTimeout(timeoutId);
+      });
+    } else if (opts.prefetch.strategy === "visible") {
+      const observer = new IntersectionObserver((entries) => {
+        entries.forEach((entry) => {
+          if (entry.isIntersecting) {
+            prefetchRoute(path);
+            observer.unobserve(element);
+          }
+        });
+      });
+      observer.observe(element);
+    } else if (opts.prefetch.strategy === "idle") {
+      if ("requestIdleCallback" in window) {
+        requestIdleCallback(() => prefetchRoute(path));
+      } else {
+        setTimeout(() => prefetchRoute(path), 1);
+      }
+    }
+  }
+  async function executeTransition(from, to) {
+    if (!opts.transitions.enabled) return;
+    const transition = state.routes.get(to)?.transition || opts.transitions.default;
+    state.transitionState = {
+      from,
+      to,
+      phase: "start"
+    };
+    if (opts.transitions.onStart) {
+      opts.transitions.onStart(from, to);
+    }
+    state.transitionState.phase = "leave";
+    await applyTransition(transition.leave, transition.duration / 2);
+    state.transitionState.phase = "enter";
+    await applyTransition(transition.enter, transition.duration / 2);
+    state.transitionState.phase = "complete";
+    stats.transitionsCompleted++;
+    if (opts.transitions.onComplete) {
+      opts.transitions.onComplete(from, to);
+    }
+    state.transitionState = null;
+  }
+  function applyTransition(animationName, duration) {
+    return new Promise((resolve) => {
+      const element = document.querySelector("[data-router-view]");
+      if (!element) {
+        resolve();
+        return;
+      }
+      element.style.animation = `${animationName} ${duration}ms`;
+      setTimeout(() => {
+        element.style.animation = "";
+        resolve();
+      }, duration);
+    });
+  }
+  function handleScroll(to, from, savedPosition) {
+    if (!opts.scrollBehavior.enabled) return;
+    if (opts.scrollBehavior.custom) {
+      const position2 = opts.scrollBehavior.custom(to, from, savedPosition);
+      scrollToPosition(position2);
+      return;
+    }
+    let position;
+    if (savedPosition && opts.scrollBehavior.savePosition) {
+      position = savedPosition;
+      stats.scrollRestores++;
+    } else if (to.hash) {
+      const element = document.querySelector(to.hash);
+      if (element) {
+        position = {
+          el: element,
+          behavior: opts.scrollBehavior.behavior
+        };
+      }
+    } else if (opts.scrollBehavior.position === "top") {
+      position = { x: 0, y: 0 };
+    } else if (opts.scrollBehavior.position === "saved" && savedPosition) {
+      position = savedPosition;
+    }
+    if (position) {
+      setTimeout(() => {
+        scrollToPosition(position);
+      }, opts.scrollBehavior.delay);
+    }
+  }
+  function scrollToPosition(position) {
+    if (typeof window === "undefined") return;
+    if (position.el) {
+      position.el.scrollIntoView({
+        behavior: position.behavior || opts.scrollBehavior.behavior
+      });
+    } else {
+      window.scrollTo({
+        left: position.x || 0,
+        top: position.y || 0,
+        behavior: position.behavior || opts.scrollBehavior.behavior
+      });
+    }
+  }
+  function saveScrollPosition(path) {
+    if (!opts.scrollBehavior.savePosition || typeof window === "undefined") return;
+    state.savedPositions.set(path, {
+      x: window.scrollX,
+      y: window.scrollY
+    });
+  }
+  async function push(path, options2 = {}) {
+    stats.navigations++;
+    const from = state.currentRoute;
+    const to = { path, ...options2 };
+    if (from) {
+      saveScrollPosition(from.path);
+    }
+    try {
+      if (opts.transitions.enabled) {
+        await executeTransition(from?.path, path);
+      }
+      const component = await loadRoute(path);
+      state.currentRoute = {
+        path,
+        component,
+        meta: state.routes.get(path)?.meta || {},
+        ...options2
+      };
+      state.history.push({
+        path,
+        timestamp: Date.now()
+      });
+      const savedPosition = state.savedPositions.get(path);
+      handleScroll(to, from, savedPosition);
+      return true;
+    } catch (error) {
+      console.error("Navigation failed:", error);
+      return false;
+    }
+  }
+  async function replace(path, options2 = {}) {
+    const result = await push(path, options2);
+    if (result && state.history.length > 1) {
+      state.history.splice(state.history.length - 2, 1);
+    }
+    return result;
+  }
+  function back() {
+    if (state.history.length > 1) {
+      const previous = state.history[state.history.length - 2];
+      push(previous.path);
+    }
+  }
+  function forward() {
+    if (typeof window !== "undefined") {
+      window.history.forward();
+    }
+  }
+  function prefetchRoutes(paths, priority) {
+    paths.forEach((path) => prefetchRoute(path, priority));
+  }
+  function getRoute(path) {
+    return state.routes.get(path);
+  }
+  function getRoutes() {
+    return Array.from(state.routes.values());
+  }
+  function getCurrentRoute() {
+    return state.currentRoute;
+  }
+  function getStats() {
+    return {
+      ...stats,
+      routesRegistered: state.routes.size,
+      prefetchQueueSize: state.prefetchQueue.length,
+      activePrefetches: state.prefetching.size,
+      loadedChunks: state.loadedChunks.size,
+      savedPositions: state.savedPositions.size,
+      historyLength: state.history.length
+    };
+  }
+  function clearCaches() {
+    state.prefetchQueue = [];
+    state.prefetching.clear();
+    state.savedPositions.clear();
+    state.routes.forEach((route) => {
+      if (route.lazy && route.loaded) {
+        route.loaded = false;
+      }
+    });
+    state.loadedChunks.clear();
+  }
+  function generateHash(input) {
+    let hash = 0;
+    for (let i = 0; i < input.length; i++) {
+      const char = input.charCodeAt(i);
+      hash = (hash << 5) - hash + char;
+      hash = hash & hash;
+    }
+    return Math.abs(hash).toString(36).substring(0, 8);
+  }
+  if (opts.prefetch.enabled && opts.prefetch.strategy === "idle") {
+    if (typeof window !== "undefined" && "requestIdleCallback" in window) {
+      requestIdleCallback(() => {
+        state.routes.forEach((route, path) => {
+          if (!route.loaded) {
+            prefetchRoute(path, opts.prefetch.priority.low);
+          }
+        });
+      });
+    }
+  }
+  return {
+    addRoute,
+    push,
+    replace,
+    back,
+    forward,
+    prefetchRoute,
+    prefetchRoutes,
+    setupPrefetchStrategy,
+    getRoute,
+    getRoutes,
+    getCurrentRoute,
+    getStats,
+    clearCaches,
+    // Expose state for testing
+    _state: state
+  };
+}
+var router = createRouter();
+export {
+  createRouter,
+  router
+};
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/router.js"],
+  "sourcesContent": ["/**\n * Enhanced Routing System\n *\n * Provides advanced routing features:\n * - Route prefetching strategies\n * - Page transitions\n * - Code splitting per route\n * - Advanced scroll behavior\n */\n\n/**\n * Create an enhanced router with advanced features\n *\n * @param {Object} options - Configuration options\n * @param {Object} [options.prefetch] - Prefetching configuration\n * @param {Object} [options.transitions] - Page transition configuration\n * @param {Object} [options.codeSplitting] - Code splitting configuration\n * @param {Object} [options.scrollBehavior] - Scroll behavior configuration\n * @returns {Object} Enhanced router instance\n */\nexport function createRouter(options = {}) {\n  const opts = {\n    mode: options.mode || 'history',\n    base: options.base || '/',\n    ...options\n  };\n\n  // Ensure nested defaults are preserved\n  opts.prefetch = {\n    enabled: false,\n    strategy: 'hover',\n    delay: 100,\n    maxConcurrent: 3,\n    priority: {\n      critical: 100,\n      high: 50,\n      normal: 0,\n      low: -50\n    },\n    ...(options.prefetch || {})\n  };\n\n  opts.transitions = {\n    enabled: false,\n    default: {\n      enter: 'fade-in',\n      leave: 'fade-out',\n      duration: 300\n    },\n    routes: {},\n    onStart: null,\n    onComplete: null,\n    ...(options.transitions || {})\n  };\n\n  opts.codeSplitting = {\n    enabled: false,\n    strategy: 'route',\n    chunkNaming: '[name]-[hash]',\n    preload: [],\n    onLoad: null,\n    ...(options.codeSplitting || {})\n  };\n\n  opts.scrollBehavior = {\n    enabled: true,\n    behavior: 'smooth',\n    position: 'top',\n    delay: 0,\n    savePosition: true,\n    custom: null,\n    ...(options.scrollBehavior || {})\n  };\n\n  // Router state\n  const state = {\n    routes: new Map(),\n    currentRoute: null,\n    history: [],\n    prefetchQueue: [],\n    prefetching: new Set(),\n    loadedChunks: new Map(),\n    savedPositions: new Map(),\n    transitionState: null\n  };\n\n  // Statistics\n  const stats = {\n    navigations: 0,\n    prefetches: 0,\n    transitionsCompleted: 0,\n    chunksLoaded: 0,\n    scrollRestores: 0\n  };\n\n  /**\n   * Register a route\n   */\n  function addRoute(path, config) {\n    state.routes.set(path, {\n      path,\n      component: config.component,\n      meta: config.meta || {},\n      beforeEnter: config.beforeEnter,\n      beforeLeave: config.beforeLeave,\n      priority: config.priority || opts.prefetch.priority.normal,\n      transition: config.transition || opts.transitions.default,\n      lazy: typeof config.component === 'function',\n      loaded: !config.component || typeof config.component !== 'function',\n      chunk: null\n    });\n\n    // Preload if configured\n    if (opts.codeSplitting.enabled &&\n        Array.isArray(opts.codeSplitting.preload) &&\n        opts.codeSplitting.preload.includes(path)) {\n      loadRoute(path);\n    }\n  }\n\n  /**\n   * Load a route component\n   */\n  async function loadRoute(path) {\n    const route = state.routes.get(path);\n    if (!route) {\n      throw new Error(`Route not found: ${path}`);\n    }\n\n    if (route.loaded) {\n      return route.component;\n    }\n\n    try {\n      const startTime = performance.now();\n\n      // Load the component\n      const component = await route.component();\n      route.component = component;\n      route.loaded = true;\n      route.chunk = opts.codeSplitting.chunkNaming\n        .replace('[name]', path.replace(/\\//g, '-'))\n        .replace('[hash]', generateHash(path));\n\n      const loadTime = performance.now() - startTime;\n\n      state.loadedChunks.set(path, {\n        path,\n        loadTime,\n        timestamp: Date.now()\n      });\n\n      stats.chunksLoaded++;\n\n      if (opts.codeSplitting.onLoad) {\n        opts.codeSplitting.onLoad(path, component, loadTime);\n      }\n\n      return component;\n    } catch (error) {\n      route.loaded = false;\n      throw new Error(`Failed to load route ${path}: ${error.message}`);\n    }\n  }\n\n  /**\n   * Prefetch a route\n   */\n  async function prefetchRoute(path, priority = opts.prefetch.priority.normal) {\n    if (!opts.prefetch.enabled) return;\n\n    const route = state.routes.get(path);\n    if (!route || route.loaded || state.prefetching.has(path)) {\n      return;\n    }\n\n    // Add to queue with priority\n    state.prefetchQueue.push({ path, priority });\n    state.prefetchQueue.sort((a, b) => b.priority - a.priority);\n\n    // Process queue\n    processPrefetchQueue();\n  }\n\n  /**\n   * Process prefetch queue\n   */\n  async function processPrefetchQueue() {\n    // Limit concurrent prefetches\n    if (state.prefetching.size >= opts.prefetch.maxConcurrent) {\n      return;\n    }\n\n    const item = state.prefetchQueue.shift();\n    if (!item) return;\n\n    const { path } = item;\n    state.prefetching.add(path);\n\n    try {\n      await loadRoute(path);\n      stats.prefetches++;\n    } catch (error) {\n      console.warn(`Prefetch failed for ${path}:`, error);\n    } finally {\n      state.prefetching.delete(path);\n      // Process next item in queue\n      if (state.prefetchQueue.length > 0) {\n        processPrefetchQueue();\n      }\n    }\n  }\n\n  /**\n   * Setup prefetch strategy\n   */\n  function setupPrefetchStrategy(element, path) {\n    if (!opts.prefetch.enabled || !element) return;\n\n    if (opts.prefetch.strategy === 'hover') {\n      let timeoutId;\n      element.addEventListener('mouseenter', () => {\n        timeoutId = setTimeout(() => {\n          prefetchRoute(path);\n        }, opts.prefetch.delay);\n      });\n      element.addEventListener('mouseleave', () => {\n        clearTimeout(timeoutId);\n      });\n    } else if (opts.prefetch.strategy === 'visible') {\n      const observer = new IntersectionObserver((entries) => {\n        entries.forEach(entry => {\n          if (entry.isIntersecting) {\n            prefetchRoute(path);\n            observer.unobserve(element);\n          }\n        });\n      });\n      observer.observe(element);\n    } else if (opts.prefetch.strategy === 'idle') {\n      if ('requestIdleCallback' in window) {\n        requestIdleCallback(() => prefetchRoute(path));\n      } else {\n        setTimeout(() => prefetchRoute(path), 1);\n      }\n    }\n  }\n\n  /**\n   * Execute page transition\n   */\n  async function executeTransition(from, to) {\n    if (!opts.transitions.enabled) return;\n\n    const transition = state.routes.get(to)?.transition || opts.transitions.default;\n\n    state.transitionState = {\n      from,\n      to,\n      phase: 'start'\n    };\n\n    if (opts.transitions.onStart) {\n      opts.transitions.onStart(from, to);\n    }\n\n    // Leave transition\n    state.transitionState.phase = 'leave';\n    await applyTransition(transition.leave, transition.duration / 2);\n\n    // Enter transition\n    state.transitionState.phase = 'enter';\n    await applyTransition(transition.enter, transition.duration / 2);\n\n    state.transitionState.phase = 'complete';\n    stats.transitionsCompleted++;\n\n    if (opts.transitions.onComplete) {\n      opts.transitions.onComplete(from, to);\n    }\n\n    state.transitionState = null;\n  }\n\n  /**\n   * Apply transition animation\n   */\n  function applyTransition(animationName, duration) {\n    return new Promise(resolve => {\n      const element = document.querySelector('[data-router-view]');\n      if (!element) {\n        resolve();\n        return;\n      }\n\n      element.style.animation = `${animationName} ${duration}ms`;\n\n      setTimeout(() => {\n        element.style.animation = '';\n        resolve();\n      }, duration);\n    });\n  }\n\n  /**\n   * Handle scroll behavior\n   */\n  function handleScroll(to, from, savedPosition) {\n    if (!opts.scrollBehavior.enabled) return;\n\n    // Custom scroll behavior\n    if (opts.scrollBehavior.custom) {\n      const position = opts.scrollBehavior.custom(to, from, savedPosition);\n      scrollToPosition(position);\n      return;\n    }\n\n    // Default scroll behavior\n    let position;\n\n    if (savedPosition && opts.scrollBehavior.savePosition) {\n      // Restore saved position\n      position = savedPosition;\n      stats.scrollRestores++;\n    } else if (to.hash) {\n      // Scroll to hash\n      const element = document.querySelector(to.hash);\n      if (element) {\n        position = {\n          el: element,\n          behavior: opts.scrollBehavior.behavior\n        };\n      }\n    } else if (opts.scrollBehavior.position === 'top') {\n      // Scroll to top\n      position = { x: 0, y: 0 };\n    } else if (opts.scrollBehavior.position === 'saved' && savedPosition) {\n      position = savedPosition;\n    }\n\n    if (position) {\n      setTimeout(() => {\n        scrollToPosition(position);\n      }, opts.scrollBehavior.delay);\n    }\n  }\n\n  /**\n   * Scroll to position\n   */\n  function scrollToPosition(position) {\n    if (typeof window === 'undefined') return;\n\n    if (position.el) {\n      position.el.scrollIntoView({\n        behavior: position.behavior || opts.scrollBehavior.behavior\n      });\n    } else {\n      window.scrollTo({\n        left: position.x || 0,\n        top: position.y || 0,\n        behavior: position.behavior || opts.scrollBehavior.behavior\n      });\n    }\n  }\n\n  /**\n   * Save current scroll position\n   */\n  function saveScrollPosition(path) {\n    if (!opts.scrollBehavior.savePosition || typeof window === 'undefined') return;\n\n    state.savedPositions.set(path, {\n      x: window.scrollX,\n      y: window.scrollY\n    });\n  }\n\n  /**\n   * Navigate to a route\n   */\n  async function push(path, options = {}) {\n    stats.navigations++;\n\n    const from = state.currentRoute;\n    const to = { path, ...options };\n\n    // Save scroll position\n    if (from) {\n      saveScrollPosition(from.path);\n    }\n\n    try {\n      // Execute transition (leave phase)\n      if (opts.transitions.enabled) {\n        await executeTransition(from?.path, path);\n      }\n\n      // Load route component\n      const component = await loadRoute(path);\n\n      // Update current route\n      state.currentRoute = {\n        path,\n        component,\n        meta: state.routes.get(path)?.meta || {},\n        ...options\n      };\n\n      // Add to history\n      state.history.push({\n        path,\n        timestamp: Date.now()\n      });\n\n      // Handle scroll\n      const savedPosition = state.savedPositions.get(path);\n      handleScroll(to, from, savedPosition);\n\n      return true;\n    } catch (error) {\n      console.error('Navigation failed:', error);\n      return false;\n    }\n  }\n\n  /**\n   * Replace current route\n   */\n  async function replace(path, options = {}) {\n    const result = await push(path, options);\n\n    if (result && state.history.length > 1) {\n      // Remove the previous history entry\n      state.history.splice(state.history.length - 2, 1);\n    }\n\n    return result;\n  }\n\n  /**\n   * Go back in history\n   */\n  function back() {\n    if (state.history.length > 1) {\n      const previous = state.history[state.history.length - 2];\n      push(previous.path);\n    }\n  }\n\n  /**\n   * Go forward (if supported by browser)\n   */\n  function forward() {\n    if (typeof window !== 'undefined') {\n      window.history.forward();\n    }\n  }\n\n  /**\n   * Prefetch multiple routes\n   */\n  function prefetchRoutes(paths, priority) {\n    paths.forEach(path => prefetchRoute(path, priority));\n  }\n\n  /**\n   * Get route by path\n   */\n  function getRoute(path) {\n    return state.routes.get(path);\n  }\n\n  /**\n   * Get all routes\n   */\n  function getRoutes() {\n    return Array.from(state.routes.values());\n  }\n\n  /**\n   * Get current route\n   */\n  function getCurrentRoute() {\n    return state.currentRoute;\n  }\n\n  /**\n   * Get router statistics\n   */\n  function getStats() {\n    return {\n      ...stats,\n      routesRegistered: state.routes.size,\n      prefetchQueueSize: state.prefetchQueue.length,\n      activePrefetches: state.prefetching.size,\n      loadedChunks: state.loadedChunks.size,\n      savedPositions: state.savedPositions.size,\n      historyLength: state.history.length\n    };\n  }\n\n  /**\n   * Clear all caches\n   */\n  function clearCaches() {\n    state.prefetchQueue = [];\n    state.prefetching.clear();\n    state.savedPositions.clear();\n\n    // Unload lazy-loaded chunks\n    state.routes.forEach(route => {\n      if (route.lazy && route.loaded) {\n        route.loaded = false;\n      }\n    });\n\n    state.loadedChunks.clear();\n  }\n\n  /**\n   * Generate hash for chunk naming\n   */\n  function generateHash(input) {\n    let hash = 0;\n    for (let i = 0; i < input.length; i++) {\n      const char = input.charCodeAt(i);\n      hash = ((hash << 5) - hash) + char;\n      hash = hash & hash;\n    }\n    return Math.abs(hash).toString(36).substring(0, 8);\n  }\n\n  // Initialize\n  if (opts.prefetch.enabled && opts.prefetch.strategy === 'idle') {\n    // Prefetch all routes on idle\n    if (typeof window !== 'undefined' && 'requestIdleCallback' in window) {\n      requestIdleCallback(() => {\n        state.routes.forEach((route, path) => {\n          if (!route.loaded) {\n            prefetchRoute(path, opts.prefetch.priority.low);\n          }\n        });\n      });\n    }\n  }\n\n  return {\n    addRoute,\n    push,\n    replace,\n    back,\n    forward,\n    prefetchRoute,\n    prefetchRoutes,\n    setupPrefetchStrategy,\n    getRoute,\n    getRoutes,\n    getCurrentRoute,\n    getStats,\n    clearCaches,\n    // Expose state for testing\n    _state: state\n  };\n}\n\n// Export default instance\nexport const router = createRouter();\n"],
+  "mappings": "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",
+  "names": ["position", "options"]
+}

package/package.json

@@ -1,27 +1,26 @@
 {
   "name": "@coherent.js/client",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.3",
   "description": "Client-side hydration/HMR utilities for Coherent.js",
   "type": "module",
-  "main": "src/index.js",
+  "main": "dist/index.js",
   "module": "dist/index.js",
   "exports": {
     ".": {
       "types": "./types/index.d.ts",
-      "development": "./src/index.js",
       "import": "./dist/index.js"
     },
     "./events": {
       "types": "./types/events.d.ts",
-      "default": "./src/events/index.js"
+      "import": "./dist/events/index.js"
     },
     "./router": {
       "types": "./types/router.d.ts",
-      "default": "./src/router.js"
+      "import": "./dist/router.js"
     },
     "./hmr": {
       "types": "./types/hmr.d.ts",
-      "default": "./src/hmr.js"
+      "import": "./dist/hmr.js"
     }
   },
   "types": "./types/index.d.ts",
@@ -49,7 +48,7 @@
   },
   "sideEffects": false,
   "devDependencies": {
-    "expect-type": "1.3.0"
+    "expect-type": "1.4.0"
   },
   "scripts": {
     "build": "node build.mjs",

package/types/events.d.ts

@@ -0,0 +1,7 @@
+export {
+  EventDelegation,
+  eventDelegation,
+  HandlerRegistry,
+  handlerRegistry,
+  wrapEvent
+} from './index.js';

package/src/index.js

@@ -1,53 +0,0 @@
-/**
- * Coherent.js Client Package
- *
- * Public API for client-side hydration, event delegation, and state management.
- *
- * @module @coherent.js/client
- */
-
-// New clean hydrate API (Phase 2)
-export { hydrate } from './hydrate.js';
-
-// Event delegation system (Plan 02-01)
-export {
-  EventDelegation,
-  eventDelegation,
-  HandlerRegistry,
-  handlerRegistry,
-  wrapEvent,
-} from './events/index.js';
-
-// State serialization (Plan 02-02)
-export {
-  serializeState,
-  deserializeState,
-  extractState,
-  serializeStateWithWarning,
-} from './hydration/index.js';
-
-// Mismatch detection (Plan 02-03)
-export {
-  detectMismatch,
-  reportMismatches,
-  formatPath,
-} from './hydration/index.js';
-
-// 1.0: removed legacy hydration re-exports — see docs/migration/1.0#removed-legacy-hydration
-
-// HMR client (Phase 4)
-export {
-  HMRClient,
-  hmrClient,
-  ModuleTracker,
-  moduleTracker,
-  createHotContext,
-  CleanupTracker,
-  cleanupTracker,
-  StateCapturer,
-  stateCapturer,
-  ErrorOverlay,
-  errorOverlay,
-  ConnectionIndicator,
-  connectionIndicator,
-} from './hmr/index.js';