specnav-core 0.2.0

package/dist/types-DnUtmOfQ.d.cts

@@ -0,0 +1,88 @@
+interface PointerSample {
+    x: number;
+    y: number;
+    t: number;
+}
+interface Velocity {
+    vx: number;
+    vy: number;
+}
+interface LinkRect {
+    href: string;
+    rect: DOMRect;
+    element: HTMLAnchorElement;
+}
+interface TrajectoryConfig {
+    lookaheadMs: number;
+    minVelocity: number;
+    sampleRate: number;
+    cancelOnDeviation: boolean;
+}
+interface CacheConfig {
+    memory: {
+        enabled: boolean;
+        maxPages: number;
+    };
+    serviceWorker: {
+        enabled: boolean;
+        ttl: number;
+        cacheName: string;
+        crossTabSync: boolean;
+        broadcastChannel: string;
+    };
+    edge: {
+        enabled: boolean;
+        maxAge: number;
+        staleWhileRevalidate: number;
+    };
+    exclude: Array<string | RegExp>;
+}
+interface MorphConfig {
+    preserveScroll: boolean;
+    preserveFocus: boolean;
+}
+interface PrefetchConfig {
+    mode: "trajectory" | "hover" | "viewport" | "eager" | false;
+    trajectory: TrajectoryConfig;
+    hover: {
+        delayMs: number;
+    };
+    throttle: {
+        maxConcurrent: number;
+        cooldownMs: number;
+    };
+    onFocus: boolean;
+    onFocusDelayMs: number;
+    exclude: Array<string | RegExp>;
+}
+interface GraphConfig {
+    enabled: boolean;
+    minConfidence: number;
+    sessionWeight: number;
+    storageKey: string;
+    maxNodes: number;
+}
+interface AdaptiveConfig {
+    batteryThreshold: number;
+    connectionTypes: {
+        slow: string[];
+        fast: string[];
+    };
+    respectSaveData: boolean;
+    respectReducedMotion: boolean;
+}
+type Strategy = "auto" | "aggressive" | "conservative" | "off";
+type CacheLayer = 1 | 2 | 3;
+interface CachedPage {
+    href: string;
+    html: string;
+    timestamp: number;
+    ttl: number;
+}
+interface NavigationGraph {
+    [fromHref: string]: {
+        [toHref: string]: number;
+    };
+}
+
+export type { AdaptiveConfig as A, CacheConfig as C, GraphConfig as G, LinkRect as L, MorphConfig as M, NavigationGraph as N, PointerSample as P, Strategy as S, TrajectoryConfig as T, Velocity as V, CacheLayer as a, CachedPage as b, PrefetchConfig as c };

package/dist/types-DnUtmOfQ.d.ts

@@ -0,0 +1,88 @@
+interface PointerSample {
+    x: number;
+    y: number;
+    t: number;
+}
+interface Velocity {
+    vx: number;
+    vy: number;
+}
+interface LinkRect {
+    href: string;
+    rect: DOMRect;
+    element: HTMLAnchorElement;
+}
+interface TrajectoryConfig {
+    lookaheadMs: number;
+    minVelocity: number;
+    sampleRate: number;
+    cancelOnDeviation: boolean;
+}
+interface CacheConfig {
+    memory: {
+        enabled: boolean;
+        maxPages: number;
+    };
+    serviceWorker: {
+        enabled: boolean;
+        ttl: number;
+        cacheName: string;
+        crossTabSync: boolean;
+        broadcastChannel: string;
+    };
+    edge: {
+        enabled: boolean;
+        maxAge: number;
+        staleWhileRevalidate: number;
+    };
+    exclude: Array<string | RegExp>;
+}
+interface MorphConfig {
+    preserveScroll: boolean;
+    preserveFocus: boolean;
+}
+interface PrefetchConfig {
+    mode: "trajectory" | "hover" | "viewport" | "eager" | false;
+    trajectory: TrajectoryConfig;
+    hover: {
+        delayMs: number;
+    };
+    throttle: {
+        maxConcurrent: number;
+        cooldownMs: number;
+    };
+    onFocus: boolean;
+    onFocusDelayMs: number;
+    exclude: Array<string | RegExp>;
+}
+interface GraphConfig {
+    enabled: boolean;
+    minConfidence: number;
+    sessionWeight: number;
+    storageKey: string;
+    maxNodes: number;
+}
+interface AdaptiveConfig {
+    batteryThreshold: number;
+    connectionTypes: {
+        slow: string[];
+        fast: string[];
+    };
+    respectSaveData: boolean;
+    respectReducedMotion: boolean;
+}
+type Strategy = "auto" | "aggressive" | "conservative" | "off";
+type CacheLayer = 1 | 2 | 3;
+interface CachedPage {
+    href: string;
+    html: string;
+    timestamp: number;
+    ttl: number;
+}
+interface NavigationGraph {
+    [fromHref: string]: {
+        [toHref: string]: number;
+    };
+}
+
+export type { AdaptiveConfig as A, CacheConfig as C, GraphConfig as G, LinkRect as L, MorphConfig as M, NavigationGraph as N, PointerSample as P, Strategy as S, TrajectoryConfig as T, Velocity as V, CacheLayer as a, CachedPage as b, PrefetchConfig as c };

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "specnav-core",
+  "version": "0.2.0",
+  "description": "Framework-agnostic speculative navigation engine with trajectory prediction, 3-layer caching, and DOM morphing",
+  "license": "MIT",
+  "author": "Abraham",
+  "homepage": "https://github.com/Robini908/specnav#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Robini908/specnav.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/Robini908/specnav/issues"
+  },
+  "keywords": [
+    "navigation",
+    "prefetch",
+    "performance",
+    "speculation"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./trajectory": {
+      "types": "./dist/trajectory.d.ts",
+      "import": "./dist/trajectory.mjs",
+      "require": "./dist/trajectory.js"
+    },
+    "./cache": {
+      "types": "./dist/cache.d.ts",
+      "import": "./dist/cache.mjs",
+      "require": "./dist/cache.js"
+    },
+    "./morpher": {
+      "types": "./dist/morpher.d.ts",
+      "import": "./dist/morpher.mjs",
+      "require": "./dist/morpher.js"
+    },
+    "./speculator": {
+      "types": "./dist/speculator.d.ts",
+      "import": "./dist/speculator.mjs",
+      "require": "./dist/speculator.js"
+    },
+    "./graph": {
+      "types": "./dist/graph.d.ts",
+      "import": "./dist/graph.mjs",
+      "require": "./dist/graph.js"
+    },
+    "./adaptive": {
+      "types": "./dist/adaptive.d.ts",
+      "import": "./dist/adaptive.mjs",
+      "require": "./dist/adaptive.js"
+    },
+    "./performance": {
+      "types": "./dist/performance.d.ts",
+      "import": "./dist/performance.mjs",
+      "require": "./dist/performance.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.0.2",
+    "typescript": "^5.8.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}