@pithyjs/router 0.1.0-beta.0

package/dist/router/integration/link-interceptor.d.ts

@@ -0,0 +1,49 @@
+/** @codex
+{
+  "id": "pithy.router.link-interceptor",
+  "title": "Link Interceptor",
+  "category": "runtime",
+  "description": "Intercepts anchor clicks and converts them to router navigations.",
+  "since": "0.1.0",
+  "stability": "stable",
+  "testing": {
+    "unit": { "required": true, "covered": false },
+    "integration": { "required": true, "covered": true, "file": "router-dispose.test.ts" },
+    "e2e": { "required": false, "covered": false }
+  }
+}
+*/
+/**
+ * LinkInterceptor - Intercepts anchor clicks and converts them to router navigations
+ *
+ * This module handles the global click event listener that intercepts same-origin
+ * anchor tag clicks and routes them through the router instead of triggering full
+ * page reloads.
+ */
+import type { RouterConfig } from '../core/types';
+/** @codexApi {"parent":"pithy.router.link-interceptor","name":"NavigateFunction","stability":"stable","signature":"(href: string) => Promise<boolean>","description":"Function type for programmatic navigation"} */
+export type NavigateFunction = (href: string) => Promise<boolean>;
+/** @codexApi {"parent":"pithy.router.link-interceptor","name":"LinkInterceptor","stability":"stable","signature":"class LinkInterceptor","description":"Intercepts anchor clicks for client-side routing"} */
+/**
+ * LinkInterceptor class
+ *
+ * Installs a global click event listener that intercepts anchor tag clicks
+ * and routes them through the router's navigate function.
+ */
+export declare class LinkInterceptor {
+    private installed;
+    private clickHandler;
+    /**
+     * Install the link interceptor
+     *
+     * @param navigate - Router's navigate function
+     * @param config - Router configuration (for linkIgnoreAttr, basePath, etc.)
+     */
+    install(navigate: NavigateFunction, config: RouterConfig): void;
+    /**
+     * Uninstall the link interceptor
+     * Removes the global click event listener
+     */
+    uninstall(): void;
+}
+//# sourceMappingURL=link-interceptor.d.ts.map

package/dist/router/integration/link-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-interceptor.d.ts","sourceRoot":"","sources":["../../../src/router/integration/link-interceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;EAcE;AACF;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,qNAAqN;AACrN,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAElE,8MAA8M;AAC9M;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAA0C;IAE9D;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IA0C/D;;;OAGG;IACH,SAAS,IAAI,IAAI;CAUlB"}

package/dist/router/integration/link-interceptor.js

@@ -0,0 +1,94 @@
+/** @codex
+{
+  "id": "pithy.router.link-interceptor",
+  "title": "Link Interceptor",
+  "category": "runtime",
+  "description": "Intercepts anchor clicks and converts them to router navigations.",
+  "since": "0.1.0",
+  "stability": "stable",
+  "testing": {
+    "unit": { "required": true, "covered": false },
+    "integration": { "required": true, "covered": true, "file": "router-dispose.test.ts" },
+    "e2e": { "required": false, "covered": false }
+  }
+}
+*/
+/**
+ * LinkInterceptor - Intercepts anchor clicks and converts them to router navigations
+ *
+ * This module handles the global click event listener that intercepts same-origin
+ * anchor tag clicks and routes them through the router instead of triggering full
+ * page reloads.
+ */
+import { isNavigationClick, shouldInterceptLink } from '../core/utils';
+/** @codexApi {"parent":"pithy.router.link-interceptor","name":"LinkInterceptor","stability":"stable","signature":"class LinkInterceptor","description":"Intercepts anchor clicks for client-side routing"} */
+/**
+ * LinkInterceptor class
+ *
+ * Installs a global click event listener that intercepts anchor tag clicks
+ * and routes them through the router's navigate function.
+ */
+export class LinkInterceptor {
+    constructor() {
+        this.installed = false;
+        this.clickHandler = null;
+    }
+    /**
+     * Install the link interceptor
+     *
+     * @param navigate - Router's navigate function
+     * @param config - Router configuration (for linkIgnoreAttr, basePath, etc.)
+     */
+    install(navigate, config) {
+        if (this.installed)
+            return;
+        this.installed = true;
+        const ignoreAttr = config.linkIgnoreAttr ?? 'data-router-ignore';
+        const findAnchor = (el) => {
+            let node = el;
+            while (node && node !== document.documentElement) {
+                if (node instanceof HTMLAnchorElement)
+                    return node;
+                node = node.parentElement;
+            }
+            return null;
+        };
+        this.clickHandler = (e) => {
+            // Skip modified clicks
+            if (!isNavigationClick(e))
+                return;
+            const a = findAnchor(e.target);
+            if (!a)
+                return;
+            // Respect opt-out
+            if (a.hasAttribute(ignoreAttr))
+                return;
+            // Check if link should be intercepted (handles all validation)
+            const href = shouldInterceptLink(a, config.basePath);
+            if (!href)
+                return;
+            // Intercept & route (only router mutates history after guards pass)
+            e.preventDefault();
+            e.stopPropagation();
+            navigate(href).catch(err => {
+                console.warn('[Router] Navigate failed:', err);
+                // IMPORTANT: do not fallback to window.location
+            });
+        };
+        document.addEventListener('click', this.clickHandler);
+    }
+    /**
+     * Uninstall the link interceptor
+     * Removes the global click event listener
+     */
+    uninstall() {
+        if (!this.installed)
+            return;
+        if (this.clickHandler) {
+            document.removeEventListener('click', this.clickHandler);
+            this.clickHandler = null;
+        }
+        this.installed = false;
+    }
+}
+//# sourceMappingURL=link-interceptor.js.map

package/dist/router/integration/link-interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-interceptor.js","sourceRoot":"","sources":["../../../src/router/integration/link-interceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;EAcE;AACF;;;;;;GAMG;AAGH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAKvE,8MAA8M;AAC9M;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAA5B;QACU,cAAS,GAAG,KAAK,CAAC;QAClB,iBAAY,GAAqC,IAAI,CAAC;IAgEhE,CAAC;IA9DC;;;;;OAKG;IACH,OAAO,CAAC,QAA0B,EAAE,MAAoB;QACtD,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,IAAI,oBAAoB,CAAC;QAEjE,MAAM,UAAU,GAAG,CAAC,EAAsB,EAA4B,EAAE;YACtE,IAAI,IAAI,GAAG,EAAwB,CAAC;YACpC,OAAO,IAAI,IAAI,IAAI,KAAK,QAAQ,CAAC,eAAe,EAAE,CAAC;gBACjD,IAAI,IAAI,YAAY,iBAAiB;oBAAE,OAAO,IAAI,CAAC;gBACnD,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC;YAC5B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QAEF,IAAI,CAAC,YAAY,GAAG,CAAC,CAAa,EAAE,EAAE;YACpC,uBAAuB;YACvB,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBAAE,OAAO;YAElC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC,CAAC;gBAAE,OAAO;YAEf,kBAAkB;YAClB,IAAI,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC;gBAAE,OAAO;YAEvC,+DAA+D;YAC/D,MAAM,IAAI,GAAG,mBAAmB,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI;gBAAE,OAAO;YAElB,oEAAoE;YACpE,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,CAAC,CAAC,eAAe,EAAE,CAAC;YAEpB,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;gBACzB,OAAO,CAAC,IAAI,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;gBAC/C,gDAAgD;YAClD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACxD,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAE5B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YACzD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@pithyjs/router",
+  "version": "0.1.0-beta.0",
+  "description": "File-based client router for PithyJS framework",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@pithyjs/core": "0.1.0-beta.0",
+    "@pithyjs/shared": "0.1.0-beta.0",
+    "@pithyjs/signals": "0.1.0-beta.0"
+  },
+  "devDependencies": {
+    "@vitest/ui": "^3.2.4",
+    "happy-dom": "^20.0.3",
+    "parse5": "^7.3.0",
+    "typescript": "^5.0.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "vitest": "^3.2.4"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "vitest",
+    "lint": "eslint 'src/**/*.{ts,tsx}'",
+    "format": "prettier -w 'src/**/*.{ts,tsx,scss,css,html}'",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prune": "ts-prune",
+    "knip": "knip",
+    "qa": "pnpm lint && pnpm typecheck && pnpm prune && pnpm knip && pnpm test"
+  }
+}