specnav-core 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,33 @@
+# @specnav/core
+
+## 0.2.0
+
+### Minor Changes
+
+- Initial public release with trajectory prediction, 3-layer caching, DOM morphing, and all 19 audit bugs fixed.
+
+  Features:
+  - Trajectory-based prefetch with cursor prediction
+  - 3-layer cache (Memory/ServiceWorker/Edge)
+  - Surgical DOM morphing with scroll/focus preservation
+  - Speculative rendering in detached containers
+  - Navigation graph learning for pattern-based prefetch
+  - Adaptive mode with battery/network awareness
+  - Next.js Link component (drop-in replacement)
+  - Edge middleware with rate limiting and CSRF protection
+
+  Bug fixes:
+  - Fixed trajectory prediction actually triggering prefetch
+  - Fixed navigation graph self-to-self transitions
+  - Fixed cache blocking Next.js **NEXT_DATA** scripts
+  - Fixed onNavigateEnd callback implementation
+  - Fixed middleware same-origin bypass
+  - Fixed null engines on first render
+  - Fixed LRU cache duplicate entries
+  - Fixed cache exclusion substring matching
+  - Fixed async adaptive initialization race
+  - Fixed duplicate Link unregistration
+  - Fixed morph refocus without containment check
+  - Fixed navigation timing polling
+  - Fixed cache hit rate tracking
+  - And 6 more fixes (see BUG_FIXES.md)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 specnav contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/adaptive.cjs

@@ -0,0 +1,108 @@
+'use strict';
+
+// src/adaptive.ts
+var DEFAULT_CONFIG = {
+  batteryThreshold: 0.2,
+  connectionTypes: {
+    slow: ["2g", "3g", "slow-2g"],
+    fast: ["4g"]
+  },
+  respectSaveData: true,
+  respectReducedMotion: true
+};
+var AdaptiveMode = class {
+  config;
+  battery = null;
+  connection = null;
+  initPromise;
+  constructor(config = {}) {
+    this.config = { ...DEFAULT_CONFIG, ...config };
+    this.initPromise = this.initialize();
+  }
+  async waitForInit() {
+    await this.initPromise;
+  }
+  async initialize() {
+    if (typeof navigator === "undefined") return;
+    if ("getBattery" in navigator) {
+      try {
+        this.battery = await navigator.getBattery();
+      } catch {
+      }
+    }
+    if ("connection" in navigator || "mozConnection" in navigator || "webkitConnection" in navigator) {
+      this.connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
+    }
+  }
+  getStrategy(baseStrategy) {
+    if (baseStrategy === "off") return "off";
+    if (baseStrategy !== "auto") return baseStrategy;
+    if (this.config.respectSaveData && this.hasSaveData()) {
+      return "off";
+    }
+    if (this.isLowBattery()) {
+      return "conservative";
+    }
+    if (this.isSlowConnection()) {
+      return "conservative";
+    }
+    return "aggressive";
+  }
+  shouldPrefetch() {
+    if (this.config.respectSaveData && this.hasSaveData()) {
+      return false;
+    }
+    if (this.isLowBattery()) {
+      return false;
+    }
+    return true;
+  }
+  shouldSpeculate() {
+    if (!this.shouldPrefetch()) {
+      return false;
+    }
+    if (this.isSlowConnection()) {
+      return false;
+    }
+    return true;
+  }
+  shouldUseTransitions() {
+    if (!this.config.respectReducedMotion) return true;
+    if (typeof window === "undefined") return true;
+    return !window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+  }
+  hasSaveData() {
+    if (typeof navigator === "undefined") return false;
+    return navigator.connection?.saveData === true || navigator.mozConnection?.saveData === true || navigator.webkitConnection?.saveData === true;
+  }
+  isLowBattery() {
+    if (!this.battery) return false;
+    return !this.battery.charging && this.battery.level < this.config.batteryThreshold;
+  }
+  isSlowConnection() {
+    if (!this.connection) return false;
+    const effectiveType = this.connection.effectiveType;
+    if (!effectiveType) return false;
+    return this.config.connectionTypes.slow.includes(effectiveType);
+  }
+  isFastConnection() {
+    if (!this.connection) return true;
+    const effectiveType = this.connection.effectiveType;
+    if (!effectiveType) return true;
+    return this.config.connectionTypes.fast.includes(effectiveType);
+  }
+  getBatteryLevel() {
+    return this.battery?.level ?? null;
+  }
+  getConnectionType() {
+    return this.connection?.effectiveType ?? null;
+  }
+};
+function createAdaptiveMode(config) {
+  return new AdaptiveMode(config);
+}
+
+exports.AdaptiveMode = AdaptiveMode;
+exports.createAdaptiveMode = createAdaptiveMode;
+//# sourceMappingURL=adaptive.cjs.map
+//# sourceMappingURL=adaptive.cjs.map

package/dist/adaptive.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adaptive.ts"],"names":[],"mappings":"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","file":"adaptive.cjs","sourcesContent":["import type { AdaptiveConfig, Strategy } from \"./types\";\n\nconst DEFAULT_CONFIG: AdaptiveConfig = {\n  batteryThreshold: 0.2,\n  connectionTypes: {\n    slow: [\"2g\", \"3g\", \"slow-2g\"],\n    fast: [\"4g\"],\n  },\n  respectSaveData: true,\n  respectReducedMotion: true,\n};\n\nexport class AdaptiveMode {\n  private config: AdaptiveConfig;\n  private battery: any = null;\n  private connection: any = null;\n  private initPromise: Promise<void>;\n\n  constructor(config: Partial<AdaptiveConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this.initPromise = this.initialize();\n  }\n\n  async waitForInit(): Promise<void> {\n    await this.initPromise;\n  }\n\n  private async initialize(): Promise<void> {\n    if (typeof navigator === \"undefined\") return;\n\n    // Battery API\n    if (\"getBattery\" in navigator) {\n      try {\n        this.battery = await (navigator as any).getBattery();\n      } catch {\n        // Not available\n      }\n    }\n\n    // Network Information API\n    if (\"connection\" in navigator || \"mozConnection\" in navigator || \"webkitConnection\" in navigator) {\n      this.connection =\n        (navigator as any).connection ||\n        (navigator as any).mozConnection ||\n        (navigator as any).webkitConnection;\n    }\n  }\n\n  getStrategy(baseStrategy: Strategy): Strategy {\n    if (baseStrategy === \"off\") return \"off\";\n    if (baseStrategy !== \"auto\") return baseStrategy;\n\n    // Check Save-Data\n    if (this.config.respectSaveData && this.hasSaveData()) {\n      return \"off\";\n    }\n\n    // Check battery\n    if (this.isLowBattery()) {\n      return \"conservative\";\n    }\n\n    // Check connection\n    if (this.isSlowConnection()) {\n      return \"conservative\";\n    }\n\n    return \"aggressive\";\n  }\n\n  shouldPrefetch(): boolean {\n    if (this.config.respectSaveData && this.hasSaveData()) {\n      return false;\n    }\n\n    if (this.isLowBattery()) {\n      return false;\n    }\n\n    return true;\n  }\n\n  shouldSpeculate(): boolean {\n    if (!this.shouldPrefetch()) {\n      return false;\n    }\n\n    if (this.isSlowConnection()) {\n      return false;\n    }\n\n    return true;\n  }\n\n  shouldUseTransitions(): boolean {\n    if (!this.config.respectReducedMotion) return true;\n\n    if (typeof window === \"undefined\") return true;\n\n    return !window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n  }\n\n  private hasSaveData(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n\n    return (\n      (navigator as any).connection?.saveData === true ||\n      (navigator as any).mozConnection?.saveData === true ||\n      (navigator as any).webkitConnection?.saveData === true\n    );\n  }\n\n  private isLowBattery(): boolean {\n    if (!this.battery) return false;\n\n    return (\n      !this.battery.charging &&\n      this.battery.level < this.config.batteryThreshold\n    );\n  }\n\n  private isSlowConnection(): boolean {\n    if (!this.connection) return false;\n\n    const effectiveType = this.connection.effectiveType;\n    if (!effectiveType) return false;\n\n    return this.config.connectionTypes.slow.includes(effectiveType);\n  }\n\n  isFastConnection(): boolean {\n    if (!this.connection) return true; // Assume fast if unknown\n\n    const effectiveType = this.connection.effectiveType;\n    if (!effectiveType) return true;\n\n    return this.config.connectionTypes.fast.includes(effectiveType);\n  }\n\n  getBatteryLevel(): number | null {\n    return this.battery?.level ?? null;\n  }\n\n  getConnectionType(): string | null {\n    return this.connection?.effectiveType ?? null;\n  }\n}\n\nexport function createAdaptiveMode(\n  config?: Partial<AdaptiveConfig>\n): AdaptiveMode {\n  return new AdaptiveMode(config);\n}\n"]}

package/dist/adaptive.d.cts

@@ -0,0 +1,24 @@
+import { A as AdaptiveConfig, S as Strategy } from './types-DnUtmOfQ.cjs';
+
+declare class AdaptiveMode {
+    private config;
+    private battery;
+    private connection;
+    private initPromise;
+    constructor(config?: Partial<AdaptiveConfig>);
+    waitForInit(): Promise<void>;
+    private initialize;
+    getStrategy(baseStrategy: Strategy): Strategy;
+    shouldPrefetch(): boolean;
+    shouldSpeculate(): boolean;
+    shouldUseTransitions(): boolean;
+    private hasSaveData;
+    private isLowBattery;
+    private isSlowConnection;
+    isFastConnection(): boolean;
+    getBatteryLevel(): number | null;
+    getConnectionType(): string | null;
+}
+declare function createAdaptiveMode(config?: Partial<AdaptiveConfig>): AdaptiveMode;
+
+export { AdaptiveMode, createAdaptiveMode };

package/dist/adaptive.d.ts

@@ -0,0 +1,24 @@
+import { A as AdaptiveConfig, S as Strategy } from './types-DnUtmOfQ.js';
+
+declare class AdaptiveMode {
+    private config;
+    private battery;
+    private connection;
+    private initPromise;
+    constructor(config?: Partial<AdaptiveConfig>);
+    waitForInit(): Promise<void>;
+    private initialize;
+    getStrategy(baseStrategy: Strategy): Strategy;
+    shouldPrefetch(): boolean;
+    shouldSpeculate(): boolean;
+    shouldUseTransitions(): boolean;
+    private hasSaveData;
+    private isLowBattery;
+    private isSlowConnection;
+    isFastConnection(): boolean;
+    getBatteryLevel(): number | null;
+    getConnectionType(): string | null;
+}
+declare function createAdaptiveMode(config?: Partial<AdaptiveConfig>): AdaptiveMode;
+
+export { AdaptiveMode, createAdaptiveMode };

package/dist/adaptive.js

@@ -0,0 +1,105 @@
+// src/adaptive.ts
+var DEFAULT_CONFIG = {
+  batteryThreshold: 0.2,
+  connectionTypes: {
+    slow: ["2g", "3g", "slow-2g"],
+    fast: ["4g"]
+  },
+  respectSaveData: true,
+  respectReducedMotion: true
+};
+var AdaptiveMode = class {
+  config;
+  battery = null;
+  connection = null;
+  initPromise;
+  constructor(config = {}) {
+    this.config = { ...DEFAULT_CONFIG, ...config };
+    this.initPromise = this.initialize();
+  }
+  async waitForInit() {
+    await this.initPromise;
+  }
+  async initialize() {
+    if (typeof navigator === "undefined") return;
+    if ("getBattery" in navigator) {
+      try {
+        this.battery = await navigator.getBattery();
+      } catch {
+      }
+    }
+    if ("connection" in navigator || "mozConnection" in navigator || "webkitConnection" in navigator) {
+      this.connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
+    }
+  }
+  getStrategy(baseStrategy) {
+    if (baseStrategy === "off") return "off";
+    if (baseStrategy !== "auto") return baseStrategy;
+    if (this.config.respectSaveData && this.hasSaveData()) {
+      return "off";
+    }
+    if (this.isLowBattery()) {
+      return "conservative";
+    }
+    if (this.isSlowConnection()) {
+      return "conservative";
+    }
+    return "aggressive";
+  }
+  shouldPrefetch() {
+    if (this.config.respectSaveData && this.hasSaveData()) {
+      return false;
+    }
+    if (this.isLowBattery()) {
+      return false;
+    }
+    return true;
+  }
+  shouldSpeculate() {
+    if (!this.shouldPrefetch()) {
+      return false;
+    }
+    if (this.isSlowConnection()) {
+      return false;
+    }
+    return true;
+  }
+  shouldUseTransitions() {
+    if (!this.config.respectReducedMotion) return true;
+    if (typeof window === "undefined") return true;
+    return !window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+  }
+  hasSaveData() {
+    if (typeof navigator === "undefined") return false;
+    return navigator.connection?.saveData === true || navigator.mozConnection?.saveData === true || navigator.webkitConnection?.saveData === true;
+  }
+  isLowBattery() {
+    if (!this.battery) return false;
+    return !this.battery.charging && this.battery.level < this.config.batteryThreshold;
+  }
+  isSlowConnection() {
+    if (!this.connection) return false;
+    const effectiveType = this.connection.effectiveType;
+    if (!effectiveType) return false;
+    return this.config.connectionTypes.slow.includes(effectiveType);
+  }
+  isFastConnection() {
+    if (!this.connection) return true;
+    const effectiveType = this.connection.effectiveType;
+    if (!effectiveType) return true;
+    return this.config.connectionTypes.fast.includes(effectiveType);
+  }
+  getBatteryLevel() {
+    return this.battery?.level ?? null;
+  }
+  getConnectionType() {
+    return this.connection?.effectiveType ?? null;
+  }
+};
+function createAdaptiveMode(config) {
+  return new AdaptiveMode(config);
+}
+
+export { AdaptiveMode, createAdaptiveMode };
+//# sourceMappingURL=adaptive.js.map
+//# sourceMappingURL=adaptive.js.map

package/dist/adaptive.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adaptive.ts"],"names":[],"mappings":";AAEA,IAAM,cAAA,GAAiC;AAAA,EACrC,gBAAA,EAAkB,GAAA;AAAA,EAClB,eAAA,EAAiB;AAAA,IACf,IAAA,EAAM,CAAC,IAAA,EAAM,IAAA,EAAM,SAAS,CAAA;AAAA,IAC5B,IAAA,EAAM,CAAC,IAAI;AAAA,GACb;AAAA,EACA,eAAA,EAAiB,IAAA;AAAA,EACjB,oBAAA,EAAsB;AACxB,CAAA;AAEO,IAAM,eAAN,MAAmB;AAAA,EAChB,MAAA;AAAA,EACA,OAAA,GAAe,IAAA;AAAA,EACf,UAAA,GAAkB,IAAA;AAAA,EAClB,WAAA;AAAA,EAER,WAAA,CAAY,MAAA,GAAkC,EAAC,EAAG;AAChD,IAAA,IAAA,CAAK,MAAA,GAAS,EAAE,GAAG,cAAA,EAAgB,GAAG,MAAA,EAAO;AAC7C,IAAA,IAAA,CAAK,WAAA,GAAc,KAAK,UAAA,EAAW;AAAA,EACrC;AAAA,EAEA,MAAM,WAAA,GAA6B;AACjC,IAAA,MAAM,IAAA,CAAK,WAAA;AAAA,EACb;AAAA,EAEA,MAAc,UAAA,GAA4B;AACxC,IAAA,IAAI,OAAO,cAAc,WAAA,EAAa;AAGtC,IAAA,IAAI,gBAAgB,SAAA,EAAW;AAC7B,MAAA,IAAI;AACF,QAAA,IAAA,CAAK,OAAA,GAAU,MAAO,SAAA,CAAkB,UAAA,EAAW;AAAA,MACrD,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF;AAGA,IAAA,IAAI,YAAA,IAAgB,SAAA,IAAa,eAAA,IAAmB,SAAA,IAAa,sBAAsB,SAAA,EAAW;AAChG,MAAA,IAAA,CAAK,UAAA,GACF,SAAA,CAAkB,UAAA,IAClB,SAAA,CAAkB,iBAClB,SAAA,CAAkB,gBAAA;AAAA,IACvB;AAAA,EACF;AAAA,EAEA,YAAY,YAAA,EAAkC;AAC5C,IAAA,IAAI,YAAA,KAAiB,OAAO,OAAO,KAAA;AACnC,IAAA,IAAI,YAAA,KAAiB,QAAQ,OAAO,YAAA;AAGpC,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,eAAA,IAAmB,IAAA,CAAK,aAAY,EAAG;AACrD,MAAA,OAAO,KAAA;AAAA,IACT;AAGA,IAAA,IAAI,IAAA,CAAK,cAAa,EAAG;AACvB,MAAA,OAAO,cAAA;AAAA,IACT;AAGA,IAAA,IAAI,IAAA,CAAK,kBAAiB,EAAG;AAC3B,MAAA,OAAO,cAAA;AAAA,IACT;AAEA,IAAA,OAAO,YAAA;AAAA,EACT;AAAA,EAEA,cAAA,GAA0B;AACxB,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,eAAA,IAAmB,IAAA,CAAK,aAAY,EAAG;AACrD,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,IAAI,IAAA,CAAK,cAAa,EAAG;AACvB,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,eAAA,GAA2B;AACzB,IAAA,IAAI,CAAC,IAAA,CAAK,cAAA,EAAe,EAAG;AAC1B,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,IAAI,IAAA,CAAK,kBAAiB,EAAG;AAC3B,MAAA,OAAO,KAAA;AAAA,IACT;AAEA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA,EAEA,oBAAA,GAAgC;AAC9B,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,CAAO,oBAAA,EAAsB,OAAO,IAAA;AAE9C,IAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,IAAA;AAE1C,IAAA,OAAO,CAAC,MAAA,CAAO,UAAA,CAAW,kCAAkC,CAAA,CAAE,OAAA;AAAA,EAChE;AAAA,EAEQ,WAAA,GAAuB;AAC7B,IAAA,IAAI,OAAO,SAAA,KAAc,WAAA,EAAa,OAAO,KAAA;AAE7C,IAAA,OACG,SAAA,CAAkB,UAAA,EAAY,QAAA,KAAa,IAAA,IAC3C,SAAA,CAAkB,eAAe,QAAA,KAAa,IAAA,IAC9C,SAAA,CAAkB,gBAAA,EAAkB,QAAA,KAAa,IAAA;AAAA,EAEtD;AAAA,EAEQ,YAAA,GAAwB;AAC9B,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,EAAS,OAAO,KAAA;AAE1B,IAAA,OACE,CAAC,KAAK,OAAA,CAAQ,QAAA,IACd,KAAK,OAAA,CAAQ,KAAA,GAAQ,KAAK,MAAA,CAAO,gBAAA;AAAA,EAErC;AAAA,EAEQ,gBAAA,GAA4B;AAClC,IAAA,IAAI,CAAC,IAAA,CAAK,UAAA,EAAY,OAAO,KAAA;AAE7B,IAAA,MAAM,aAAA,GAAgB,KAAK,UAAA,CAAW,aAAA;AACtC,IAAA,IAAI,CAAC,eAAe,OAAO,KAAA;AAE3B,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,eAAA,CAAgB,IAAA,CAAK,SAAS,aAAa,CAAA;AAAA,EAChE;AAAA,EAEA,gBAAA,GAA4B;AAC1B,IAAA,IAAI,CAAC,IAAA,CAAK,UAAA,EAAY,OAAO,IAAA;AAE7B,IAAA,MAAM,aAAA,GAAgB,KAAK,UAAA,CAAW,aAAA;AACtC,IAAA,IAAI,CAAC,eAAe,OAAO,IAAA;AAE3B,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,eAAA,CAAgB,IAAA,CAAK,SAAS,aAAa,CAAA;AAAA,EAChE;AAAA,EAEA,eAAA,GAAiC;AAC/B,IAAA,OAAO,IAAA,CAAK,SAAS,KAAA,IAAS,IAAA;AAAA,EAChC;AAAA,EAEA,iBAAA,GAAmC;AACjC,IAAA,OAAO,IAAA,CAAK,YAAY,aAAA,IAAiB,IAAA;AAAA,EAC3C;AACF;AAEO,SAAS,mBACd,MAAA,EACc;AACd,EAAA,OAAO,IAAI,aAAa,MAAM,CAAA;AAChC","file":"adaptive.js","sourcesContent":["import type { AdaptiveConfig, Strategy } from \"./types\";\n\nconst DEFAULT_CONFIG: AdaptiveConfig = {\n  batteryThreshold: 0.2,\n  connectionTypes: {\n    slow: [\"2g\", \"3g\", \"slow-2g\"],\n    fast: [\"4g\"],\n  },\n  respectSaveData: true,\n  respectReducedMotion: true,\n};\n\nexport class AdaptiveMode {\n  private config: AdaptiveConfig;\n  private battery: any = null;\n  private connection: any = null;\n  private initPromise: Promise<void>;\n\n  constructor(config: Partial<AdaptiveConfig> = {}) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this.initPromise = this.initialize();\n  }\n\n  async waitForInit(): Promise<void> {\n    await this.initPromise;\n  }\n\n  private async initialize(): Promise<void> {\n    if (typeof navigator === \"undefined\") return;\n\n    // Battery API\n    if (\"getBattery\" in navigator) {\n      try {\n        this.battery = await (navigator as any).getBattery();\n      } catch {\n        // Not available\n      }\n    }\n\n    // Network Information API\n    if (\"connection\" in navigator || \"mozConnection\" in navigator || \"webkitConnection\" in navigator) {\n      this.connection =\n        (navigator as any).connection ||\n        (navigator as any).mozConnection ||\n        (navigator as any).webkitConnection;\n    }\n  }\n\n  getStrategy(baseStrategy: Strategy): Strategy {\n    if (baseStrategy === \"off\") return \"off\";\n    if (baseStrategy !== \"auto\") return baseStrategy;\n\n    // Check Save-Data\n    if (this.config.respectSaveData && this.hasSaveData()) {\n      return \"off\";\n    }\n\n    // Check battery\n    if (this.isLowBattery()) {\n      return \"conservative\";\n    }\n\n    // Check connection\n    if (this.isSlowConnection()) {\n      return \"conservative\";\n    }\n\n    return \"aggressive\";\n  }\n\n  shouldPrefetch(): boolean {\n    if (this.config.respectSaveData && this.hasSaveData()) {\n      return false;\n    }\n\n    if (this.isLowBattery()) {\n      return false;\n    }\n\n    return true;\n  }\n\n  shouldSpeculate(): boolean {\n    if (!this.shouldPrefetch()) {\n      return false;\n    }\n\n    if (this.isSlowConnection()) {\n      return false;\n    }\n\n    return true;\n  }\n\n  shouldUseTransitions(): boolean {\n    if (!this.config.respectReducedMotion) return true;\n\n    if (typeof window === \"undefined\") return true;\n\n    return !window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n  }\n\n  private hasSaveData(): boolean {\n    if (typeof navigator === \"undefined\") return false;\n\n    return (\n      (navigator as any).connection?.saveData === true ||\n      (navigator as any).mozConnection?.saveData === true ||\n      (navigator as any).webkitConnection?.saveData === true\n    );\n  }\n\n  private isLowBattery(): boolean {\n    if (!this.battery) return false;\n\n    return (\n      !this.battery.charging &&\n      this.battery.level < this.config.batteryThreshold\n    );\n  }\n\n  private isSlowConnection(): boolean {\n    if (!this.connection) return false;\n\n    const effectiveType = this.connection.effectiveType;\n    if (!effectiveType) return false;\n\n    return this.config.connectionTypes.slow.includes(effectiveType);\n  }\n\n  isFastConnection(): boolean {\n    if (!this.connection) return true; // Assume fast if unknown\n\n    const effectiveType = this.connection.effectiveType;\n    if (!effectiveType) return true;\n\n    return this.config.connectionTypes.fast.includes(effectiveType);\n  }\n\n  getBatteryLevel(): number | null {\n    return this.battery?.level ?? null;\n  }\n\n  getConnectionType(): string | null {\n    return this.connection?.effectiveType ?? null;\n  }\n}\n\nexport function createAdaptiveMode(\n  config?: Partial<AdaptiveConfig>\n): AdaptiveMode {\n  return new AdaptiveMode(config);\n}\n"]}

package/dist/cache.cjs

@@ -0,0 +1,224 @@
+'use strict';
+
+// src/cache.ts
+var DEFAULT_CONFIG = {
+  memory: {
+    enabled: true,
+    maxPages: 10
+  },
+  serviceWorker: {
+    enabled: true,
+    ttl: 300,
+    cacheName: "specnav-v1",
+    crossTabSync: true,
+    broadcastChannel: "specnav-sync"
+  },
+  edge: {
+    enabled: true,
+    maxAge: 60,
+    staleWhileRevalidate: 300
+  },
+  exclude: []
+};
+var CacheManager = class {
+  config;
+  memoryCache = /* @__PURE__ */ new Map();
+  accessOrder = [];
+  broadcastChannel;
+  onCacheHit;
+  constructor(config = {}, callbacks) {
+    this.config = { ...DEFAULT_CONFIG, ...config };
+    this.onCacheHit = callbacks?.onCacheHit;
+    if (this.config.serviceWorker.enabled && this.config.serviceWorker.crossTabSync && typeof BroadcastChannel !== "undefined") {
+      this.broadcastChannel = new BroadcastChannel(
+        this.config.serviceWorker.broadcastChannel
+      );
+      this.broadcastChannel.onmessage = this.handleBroadcast;
+    }
+  }
+  async get(href) {
+    if (this.isExcluded(href)) return null;
+    const memoryHit = this.getFromMemory(href);
+    if (memoryHit) {
+      this.onCacheHit?.(href, 1);
+      return memoryHit;
+    }
+    if (this.config.serviceWorker.enabled) {
+      const swHit = await this.getFromServiceWorker(href);
+      if (swHit) {
+        this.onCacheHit?.(href, 2);
+        this.setInMemory(href, swHit);
+        return swHit;
+      }
+    }
+    return null;
+  }
+  async set(href, html) {
+    if (this.isExcluded(href)) return;
+    const sanitizedHref = this.sanitizeHref(href);
+    if (!sanitizedHref) return;
+    if (this.containsDangerousContent(html)) {
+      console.warn(`Refusing to cache potentially dangerous content from ${sanitizedHref}`);
+      return;
+    }
+    const page = {
+      href: sanitizedHref,
+      html,
+      timestamp: Date.now(),
+      ttl: this.config.serviceWorker.ttl
+    };
+    if (this.config.memory.enabled) {
+      this.setInMemory(sanitizedHref, html);
+    }
+    if (this.config.serviceWorker.enabled) {
+      await this.setInServiceWorker(page);
+      this.broadcastSet(sanitizedHref);
+    }
+  }
+  containsDangerousContent(html) {
+    const dangerousPatterns = [
+      /on\w+\s*=\s*["'][^"']*["']/i,
+      // Inline event handlers
+      /javascript:/i
+      // javascript: URLs
+    ];
+    const scriptRegex = /<script([^>]*)>([\s\S]*?)<\/script>/gi;
+    let match;
+    while ((match = scriptRegex.exec(html)) !== null) {
+      const attrs = match[1] || "";
+      if (/src\s*=/.test(attrs)) continue;
+      if (/type\s*=\s*["']?(application\/json|application\/ld\+json|text\/template)["']?/i.test(attrs)) continue;
+      if (/id\s*=\s*["']__NEXT_DATA__["']/i.test(attrs)) continue;
+      return true;
+    }
+    return dangerousPatterns.some((pattern) => pattern.test(html));
+  }
+  sanitizeHref(href) {
+    try {
+      const url = new URL(href, window.location.origin);
+      if (url.origin !== window.location.origin) return null;
+      return url.pathname + url.search + url.hash;
+    } catch {
+      return null;
+    }
+  }
+  clear(href) {
+    if (href) {
+      this.memoryCache.delete(href);
+      this.accessOrder = this.accessOrder.filter((h) => h !== href);
+      this.clearFromServiceWorker(href);
+    } else {
+      this.memoryCache.clear();
+      this.accessOrder = [];
+      this.clearAllServiceWorker();
+    }
+  }
+  getSize() {
+    return this.memoryCache.size;
+  }
+  destroy() {
+    this.memoryCache.clear();
+    this.accessOrder = [];
+    this.broadcastChannel?.close();
+  }
+  getFromMemory(href) {
+    const page = this.memoryCache.get(href);
+    if (!page) return null;
+    this.accessOrder = this.accessOrder.filter((h) => h !== href);
+    this.accessOrder.push(href);
+    return page.html;
+  }
+  setInMemory(href, html) {
+    const maxPageSize = 5 * 1024 * 1024;
+    if (html.length > maxPageSize) {
+      console.warn(`Page ${href} exceeds max size, not caching`);
+      return;
+    }
+    this.memoryCache.set(href, {
+      href,
+      html,
+      timestamp: Date.now(),
+      ttl: this.config.serviceWorker.ttl
+    });
+    const existingIndex = this.accessOrder.indexOf(href);
+    if (existingIndex !== -1) {
+      this.accessOrder.splice(existingIndex, 1);
+    }
+    this.accessOrder.push(href);
+    if (this.memoryCache.size > this.config.memory.maxPages) {
+      const oldest = this.accessOrder.shift();
+      if (oldest) this.memoryCache.delete(oldest);
+    }
+  }
+  async getFromServiceWorker(href) {
+    if (typeof caches === "undefined") return null;
+    try {
+      const cache = await caches.open(this.config.serviceWorker.cacheName);
+      const response = await cache.match(href);
+      if (!response) return null;
+      const data = await response.json();
+      const page = data;
+      const age = Date.now() - page.timestamp;
+      if (age > page.ttl * 1e3) {
+        await cache.delete(href);
+        return null;
+      }
+      return page.html;
+    } catch {
+      return null;
+    }
+  }
+  async setInServiceWorker(page) {
+    if (typeof caches === "undefined") return;
+    try {
+      const cache = await caches.open(this.config.serviceWorker.cacheName);
+      const response = new Response(JSON.stringify(page), {
+        headers: {
+          "Content-Type": "application/json",
+          "Cache-Control": `max-age=${this.config.edge.maxAge}, stale-while-revalidate=${this.config.edge.staleWhileRevalidate}`
+        }
+      });
+      await cache.put(page.href, response);
+    } catch {
+    }
+  }
+  async clearFromServiceWorker(href) {
+    if (typeof caches === "undefined") return;
+    try {
+      const cache = await caches.open(this.config.serviceWorker.cacheName);
+      await cache.delete(href);
+    } catch {
+    }
+  }
+  async clearAllServiceWorker() {
+    if (typeof caches === "undefined") return;
+    try {
+      await caches.delete(this.config.serviceWorker.cacheName);
+    } catch {
+    }
+  }
+  isExcluded(href) {
+    return this.config.exclude.some((pattern) => {
+      if (typeof pattern === "string") {
+        return pattern.includes("*") ? new RegExp(pattern.replace(/\*/g, ".*")).test(href) : href === pattern;
+      }
+      return pattern.test(href);
+    });
+  }
+  broadcastSet(href) {
+    this.broadcastChannel?.postMessage({ type: "set", href });
+  }
+  handleBroadcast = (event) => {
+    if (event.data.type === "set") {
+      this.memoryCache.delete(event.data.href);
+    }
+  };
+};
+function createCacheManager(config, callbacks) {
+  return new CacheManager(config, callbacks);
+}
+
+exports.CacheManager = CacheManager;
+exports.createCacheManager = createCacheManager;
+//# sourceMappingURL=cache.cjs.map
+//# sourceMappingURL=cache.cjs.map

package/dist/cache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache.ts"],"names":[],"mappings":"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","file":"cache.cjs","sourcesContent":["import type { CacheConfig, CachedPage, CacheLayer } from \"./types\";\n\nconst DEFAULT_CONFIG: CacheConfig = {\n  memory: {\n    enabled: true,\n    maxPages: 10,\n  },\n  serviceWorker: {\n    enabled: true,\n    ttl: 300,\n    cacheName: \"specnav-v1\",\n    crossTabSync: true,\n    broadcastChannel: \"specnav-sync\",\n  },\n  edge: {\n    enabled: true,\n    maxAge: 60,\n    staleWhileRevalidate: 300,\n  },\n  exclude: [],\n};\n\nexport class CacheManager {\n  private config: CacheConfig;\n  private memoryCache: Map<string, CachedPage> = new Map();\n  private accessOrder: string[] = [];\n  private broadcastChannel?: BroadcastChannel;\n  private onCacheHit?: (href: string, layer: CacheLayer) => void;\n\n  constructor(\n    config: Partial<CacheConfig> = {},\n    callbacks?: { onCacheHit?: (href: string, layer: CacheLayer) => void }\n  ) {\n    this.config = { ...DEFAULT_CONFIG, ...config };\n    this.onCacheHit = callbacks?.onCacheHit;\n\n    if (\n      this.config.serviceWorker.enabled &&\n      this.config.serviceWorker.crossTabSync &&\n      typeof BroadcastChannel !== \"undefined\"\n    ) {\n      this.broadcastChannel = new BroadcastChannel(\n        this.config.serviceWorker.broadcastChannel\n      );\n      this.broadcastChannel.onmessage = this.handleBroadcast;\n    }\n  }\n\n  async get(href: string): Promise<string | null> {\n    if (this.isExcluded(href)) return null;\n\n    // L1: Memory cache\n    const memoryHit = this.getFromMemory(href);\n    if (memoryHit) {\n      this.onCacheHit?.(href, 1);\n      return memoryHit;\n    }\n\n    // L2: Service Worker cache\n    if (this.config.serviceWorker.enabled) {\n      const swHit = await this.getFromServiceWorker(href);\n      if (swHit) {\n        this.onCacheHit?.(href, 2);\n        this.setInMemory(href, swHit);\n        return swHit;\n      }\n    }\n\n    return null;\n  }\n\n  async set(href: string, html: string): Promise<void> {\n    if (this.isExcluded(href)) return;\n\n    // Sanitize href to prevent cache poisoning\n    const sanitizedHref = this.sanitizeHref(href);\n    if (!sanitizedHref) return;\n\n    // Validate HTML doesn't contain dangerous inline scripts\n    if (this.containsDangerousContent(html)) {\n      console.warn(`Refusing to cache potentially dangerous content from ${sanitizedHref}`);\n      return;\n    }\n\n    const page: CachedPage = {\n      href: sanitizedHref,\n      html,\n      timestamp: Date.now(),\n      ttl: this.config.serviceWorker.ttl,\n    };\n\n    // L1: Memory\n    if (this.config.memory.enabled) {\n      this.setInMemory(sanitizedHref, html);\n    }\n\n    // L2: Service Worker\n    if (this.config.serviceWorker.enabled) {\n      await this.setInServiceWorker(page);\n      this.broadcastSet(sanitizedHref);\n    }\n  }\n\n  private containsDangerousContent(html: string): boolean {\n    // Check for inline event handlers and javascript: URLs\n    const dangerousPatterns = [\n      /on\\w+\\s*=\\s*[\"'][^\"']*[\"']/i, // Inline event handlers\n      /javascript:/i, // javascript: URLs\n    ];\n\n    // Check for inline scripts, but exclude safe types\n    const scriptRegex = /<script([^>]*)>([\\s\\S]*?)<\\/script>/gi;\n    let match;\n    while ((match = scriptRegex.exec(html)) !== null) {\n      const attrs = match[1] || \"\";\n      \n      // Allow scripts with src attribute\n      if (/src\\s*=/.test(attrs)) continue;\n      \n      // Allow safe script types (JSON data, templates)\n      if (/type\\s*=\\s*[\"']?(application\\/json|application\\/ld\\+json|text\\/template)[\"']?/i.test(attrs)) continue;\n      \n      // Allow Next.js data script\n      if (/id\\s*=\\s*[\"']__NEXT_DATA__[\"']/i.test(attrs)) continue;\n      \n      // If we get here, it's an inline script without safe type\n      return true;\n    }\n\n    return dangerousPatterns.some(pattern => pattern.test(html));\n  }\n\n  private sanitizeHref(href: string): string | null {\n    try {\n      const url = new URL(href, window.location.origin);\n      // Only allow same-origin URLs\n      if (url.origin !== window.location.origin) return null;\n      return url.pathname + url.search + url.hash;\n    } catch {\n      return null;\n    }\n  }\n\n  clear(href?: string): void {\n    if (href) {\n      this.memoryCache.delete(href);\n      this.accessOrder = this.accessOrder.filter((h) => h !== href);\n      this.clearFromServiceWorker(href);\n    } else {\n      this.memoryCache.clear();\n      this.accessOrder = [];\n      this.clearAllServiceWorker();\n    }\n  }\n\n  getSize(): number {\n    return this.memoryCache.size;\n  }\n\n  destroy(): void {\n    this.memoryCache.clear();\n    this.accessOrder = [];\n    this.broadcastChannel?.close();\n  }\n\n  private getFromMemory(href: string): string | null {\n    const page = this.memoryCache.get(href);\n    if (!page) return null;\n\n    // Update LRU order\n    this.accessOrder = this.accessOrder.filter((h) => h !== href);\n    this.accessOrder.push(href);\n\n    return page.html;\n  }\n\n  private setInMemory(href: string, html: string): void {\n    // Prevent memory exhaustion - limit individual page size\n    const maxPageSize = 5 * 1024 * 1024; // 5MB per page\n    if (html.length > maxPageSize) {\n      console.warn(`Page ${href} exceeds max size, not caching`);\n      return;\n    }\n\n    this.memoryCache.set(href, {\n      href,\n      html,\n      timestamp: Date.now(),\n      ttl: this.config.serviceWorker.ttl,\n    });\n\n    // Deduplicate before adding to accessOrder\n    const existingIndex = this.accessOrder.indexOf(href);\n    if (existingIndex !== -1) {\n      this.accessOrder.splice(existingIndex, 1);\n    }\n    this.accessOrder.push(href);\n\n    // LRU eviction\n    if (this.memoryCache.size > this.config.memory.maxPages) {\n      const oldest = this.accessOrder.shift();\n      if (oldest) this.memoryCache.delete(oldest);\n    }\n  }\n\n  private async getFromServiceWorker(href: string): Promise<string | null> {\n    if (typeof caches === \"undefined\") return null;\n\n    try {\n      const cache = await caches.open(this.config.serviceWorker.cacheName);\n      const response = await cache.match(href);\n\n      if (!response) return null;\n\n      const data = await response.json();\n      const page = data as CachedPage;\n\n      // Check TTL\n      const age = Date.now() - page.timestamp;\n      if (age > page.ttl * 1000) {\n        await cache.delete(href);\n        return null;\n      }\n\n      return page.html;\n    } catch {\n      return null;\n    }\n  }\n\n  private async setInServiceWorker(page: CachedPage): Promise<void> {\n    if (typeof caches === \"undefined\") return;\n\n    try {\n      const cache = await caches.open(this.config.serviceWorker.cacheName);\n      const response = new Response(JSON.stringify(page), {\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"Cache-Control\": `max-age=${this.config.edge.maxAge}, stale-while-revalidate=${this.config.edge.staleWhileRevalidate}`,\n        },\n      });\n      await cache.put(page.href, response);\n    } catch {\n      // Silently fail\n    }\n  }\n\n  private async clearFromServiceWorker(href: string): Promise<void> {\n    if (typeof caches === \"undefined\") return;\n\n    try {\n      const cache = await caches.open(this.config.serviceWorker.cacheName);\n      await cache.delete(href);\n    } catch {\n      // Silently fail\n    }\n  }\n\n  private async clearAllServiceWorker(): Promise<void> {\n    if (typeof caches === \"undefined\") return;\n\n    try {\n      await caches.delete(this.config.serviceWorker.cacheName);\n    } catch {\n      // Silently fail\n    }\n  }\n\n  private isExcluded(href: string): boolean {\n    return this.config.exclude.some((pattern) => {\n      if (typeof pattern === \"string\") {\n        return pattern.includes(\"*\")\n          ? new RegExp(pattern.replace(/\\*/g, \".*\")).test(href)\n          : href === pattern;\n      }\n      return pattern.test(href);\n    });\n  }\n\n  private broadcastSet(href: string): void {\n    this.broadcastChannel?.postMessage({ type: \"set\", href });\n  }\n\n  private handleBroadcast = (event: MessageEvent): void => {\n    if (event.data.type === \"set\") {\n      // Invalidate memory cache to force fetch from SW\n      this.memoryCache.delete(event.data.href);\n    }\n  };\n}\n\nexport function createCacheManager(\n  config?: Partial<CacheConfig>,\n  callbacks?: { onCacheHit?: (href: string, layer: CacheLayer) => void }\n): CacheManager {\n  return new CacheManager(config, callbacks);\n}\n"]}

package/dist/cache.d.cts

@@ -0,0 +1,33 @@
+import { C as CacheConfig, a as CacheLayer } from './types-DnUtmOfQ.cjs';
+
+declare class CacheManager {
+    private config;
+    private memoryCache;
+    private accessOrder;
+    private broadcastChannel?;
+    private onCacheHit?;
+    constructor(config?: Partial<CacheConfig>, callbacks?: {
+        onCacheHit?: (href: string, layer: CacheLayer) => void;
+    });
+    get(href: string): Promise<string | null>;
+    set(href: string, html: string): Promise<void>;
+    private containsDangerousContent;
+    private sanitizeHref;
+    clear(href?: string): void;
+    getSize(): number;
+    destroy(): void;
+    private getFromMemory;
+    private setInMemory;
+    private getFromServiceWorker;
+    private setInServiceWorker;
+    private clearFromServiceWorker;
+    private clearAllServiceWorker;
+    private isExcluded;
+    private broadcastSet;
+    private handleBroadcast;
+}
+declare function createCacheManager(config?: Partial<CacheConfig>, callbacks?: {
+    onCacheHit?: (href: string, layer: CacheLayer) => void;
+}): CacheManager;
+
+export { CacheManager, createCacheManager };