Add per-package READMEs and bump to 0.1.1

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: babu-ch

packages/core/README.md

@@ -0,0 +1,55 @@
+# link-interceptor
+
+Framework-agnostic core for intercepting all `<a>` tag clicks in your SPA. Provides callbacks for internal and external links with URL mutation support.
+
+For framework-specific wrappers, see:
+- [vue-link-interceptor](https://www.npmjs.com/package/vue-link-interceptor) — Vue 3 plugin
+- [react-link-interceptor](https://www.npmjs.com/package/react-link-interceptor) — React hook
+- [svelte-link-interceptor](https://www.npmjs.com/package/svelte-link-interceptor) — Svelte action
+
+## Install
+
+```bash
+npm install link-interceptor
+```
+
+## Usage
+
+```ts
+import { interceptLinks } from 'link-interceptor'
+
+const cleanup = interceptLinks({
+  onInternalLink(ctx) {
+    ctx.preventDefault()
+    history.pushState(null, '', ctx.path)
+  },
+  onExternalLink(ctx) {
+    ctx.url.searchParams.set('utm_source', 'myapp')
+  },
+})
+
+// When done:
+cleanup()
+```
+
+## API
+
+### `interceptLinks(options): () => void`
+
+Registers a capture-phase click listener on `document`. Returns a cleanup function.
+
+### LinkContext
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `url` | `URL` | Parsed URL (mutable — changes reflected on `anchor.href`) |
+| `anchor` | `HTMLAnchorElement` | The clicked `<a>` element |
+| `event` | `MouseEvent` | The original click event |
+| `path` | `string` | `url.pathname + url.search + url.hash` |
+| `isExternal` | `boolean` | Whether the link is external |
+| `isModifierClick` | `boolean` | Whether Ctrl/Meta/Shift/Alt was held |
+| `preventDefault()` | `() => void` | Cancel the default navigation |
+
+## License
+
+[MIT](https://github.com/babu-ch/link-interceptor/blob/main/LICENSE)

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "link-interceptor",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Intercept all <a> tag clicks in your SPA — framework-agnostic core for handling internal and external link navigation.",
   "keywords": [
     "anchor",
@@ -27,6 +27,7 @@
     "node": ">=18.0.0"
   },
   "files": [
+    "README.md",
     "dist"
   ],
   "type": "module",

packages/react/README.md

@@ -0,0 +1,36 @@
+# react-link-interceptor
+
+React hook to intercept all `<a>` tag clicks in your SPA. Handle internal routing and external link modifications with ease.
+
+## Install
+
+```bash
+npm install react-link-interceptor
+```
+
+## Usage
+
+```tsx
+import { useLinkInterceptor } from 'react-link-interceptor'
+
+function App() {
+  useLinkInterceptor({
+    onInternalLink(ctx) {
+      ctx.preventDefault()
+      navigate(ctx.path) // react-router
+    },
+    onExternalLink(ctx) {
+      ctx.url.searchParams.set('utm_source', 'myapp')
+    },
+  })
+  return <div>...</div>
+}
+```
+
+## Docs & Playground
+
+https://babu-ch.github.io/link-interceptor/
+
+## License
+
+[MIT](https://github.com/babu-ch/link-interceptor/blob/main/LICENSE)

packages/react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-link-interceptor",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "React hook to intercept all <a> tag clicks in your SPA — handle internal routing and external link modifications with ease.",
   "keywords": [
     "anchor",
@@ -27,6 +27,7 @@
     "node": ">=18.0.0"
   },
   "files": [
+    "README.md",
     "dist"
   ],
   "type": "module",

packages/svelte/README.md

@@ -0,0 +1,39 @@
+# svelte-link-interceptor
+
+Svelte action to intercept all `<a>` tag clicks in your SPA. Handle internal routing and external link modifications with ease.
+
+## Install
+
+```bash
+npm install svelte-link-interceptor
+```
+
+## Usage
+
+```svelte
+<script>
+  import { linkInterceptor } from 'svelte-link-interceptor'
+
+  const options = {
+    onInternalLink(ctx) {
+      ctx.preventDefault()
+      goto(ctx.path) // SvelteKit
+    },
+    onExternalLink(ctx) {
+      ctx.url.searchParams.set('utm_source', 'myapp')
+    },
+  }
+</script>
+
+<div use:linkInterceptor={options}>
+  ...
+</div>
+```
+
+## Docs & Playground
+
+https://babu-ch.github.io/link-interceptor/
+
+## License
+
+[MIT](https://github.com/babu-ch/link-interceptor/blob/main/LICENSE)

packages/svelte/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svelte-link-interceptor",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Svelte action to intercept all <a> tag clicks in your SPA — handle internal routing and external link modifications with ease.",
   "keywords": [
     "anchor",
@@ -27,6 +27,7 @@
     "node": ">=18.0.0"
   },
   "files": [
+    "README.md",
     "dist"
   ],
   "type": "module",

packages/vue/README.md

@@ -0,0 +1,33 @@
+# vue-link-interceptor
+
+Vue 3 plugin to intercept all `<a>` tag clicks in your SPA. Handle internal routing and external link modifications with ease.
+
+## Install
+
+```bash
+npm install vue-link-interceptor
+```
+
+## Usage
+
+```ts
+import { linkInterceptorPlugin } from 'vue-link-interceptor'
+
+app.use(linkInterceptorPlugin, {
+  onInternalLink(ctx) {
+    ctx.preventDefault()
+    router.push(ctx.path)
+  },
+  onExternalLink(ctx) {
+    ctx.url.searchParams.set('utm_source', 'myapp')
+  },
+})
+```
+
+## Docs & Playground
+
+https://babu-ch.github.io/link-interceptor/
+
+## License
+
+[MIT](https://github.com/babu-ch/link-interceptor/blob/main/LICENSE)

packages/vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vue-link-interceptor",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Vue 3 plugin to intercept all <a> tag clicks in your SPA — handle internal routing and external link modifications with ease.",
   "keywords": [
     "anchor",
@@ -28,6 +28,7 @@
     "node": ">=18.0.0"
   },
   "files": [
+    "README.md",
     "dist"
   ],
   "type": "module",