apostil 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Batzorig Tsergiinkhuu
+
+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/README.md

@@ -0,0 +1,169 @@
+# Apostil
+
+Pin-and-comment feedback overlay for React & Next.js. Let your team leave contextual feedback directly on the UI.
+
+## Features
+
+- **Click to pin** — drop comment pins anywhere on the page
+- **Smart target detection** — auto-anchors to nearest meaningful element
+- **Thread-based** — replies, resolve/unresolve, delete
+- **Keyboard shortcuts** — `C` to toggle comment mode, `Esc` to cancel
+- **Popover-aware** — comments inside modals/popovers re-appear when reopened
+- **All Pages view** — see every comment across your project in one sidebar
+- **Auto z-index** — overlay detects highest z-index and sits above everything
+- **SSR-safe** — works with Next.js App Router
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install apostil        # or: pnpm add apostil / yarn add apostil
+```
+
+### 2. Initialize
+
+```bash
+npx apostil init           # or: pnpm exec apostil init
+```
+
+This will:
+- Create `app/api/apostil/route.ts` — API route for comment storage
+- Create `components/apostil-wrapper.tsx` — pre-configured wrapper component
+- Create `.apostil/` directory and add it to `.gitignore`
+- **Automatically wrap `{children}` in your root layout** with `<ApostilWrapper>`
+
+### 3. Done
+
+```bash
+npm run dev
+```
+
+Press `C` on any page to start commenting. That's it.
+
+## How It Works
+
+Comments are stored as JSON files in `.apostil/`:
+
+```
+.apostil/
+├── home.json
+├── about.json
+└── dashboard--settings.json
+```
+
+The wrapper auto-detects the current page from `usePathname()` and loads the corresponding comments. Every page in your app gets commenting automatically.
+
+## Uninstall
+
+```bash
+npx apostil remove
+npm uninstall apostil
+```
+
+`remove` cleans up everything — deletes the API route, wrapper component, `.apostil/` directory, removes the `<ApostilWrapper>` from your layout, and cleans `.gitignore`.
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `C` | Toggle comment mode |
+| `Escape` | Cancel unsaved comment / exit comment mode |
+| `Enter` | Submit comment |
+
+## Components
+
+### `<ApostilProvider>`
+
+Core context provider. Use directly for custom setups:
+
+```tsx
+<ApostilProvider pageId="my-page" storage={customAdapter}>
+  {children}
+  <CommentOverlay />
+  <CommentToggle />
+</ApostilProvider>
+```
+
+### `<CommentOverlay>`
+
+Captures clicks in comment mode. Auto-detects z-index to sit above popovers and modals.
+
+### `<CommentToggle>`
+
+Floating button (bottom-right) with unresolved count badge.
+
+### `<CommentSidebar>`
+
+Right panel with two tabs:
+- **This Page** — comments on the current page
+- **All Pages** — every comment across the project. Click to navigate.
+
+## Hooks
+
+```tsx
+import { useApostil, useComments, useCommentMode } from "apostil";
+
+const { threads, user, addThread, addReply, resolveThread } = useApostil();
+const { openThreads, resolvedThreads, unresolvedCount } = useComments();
+const { commentMode, toggleCommentMode, sidebarOpen, toggleSidebar } = useCommentMode();
+```
+
+## Storage Adapters
+
+### Default (file-based)
+
+No config needed. `npx apostil init` sets up the API route that reads/writes `.apostil/` JSON files.
+
+### localStorage
+
+```tsx
+import { localStorageAdapter } from "apostil/adapters/localStorage";
+<ApostilProvider pageId="my-page" storage={localStorageAdapter}>
+```
+
+### Custom REST API
+
+```tsx
+import { createRestAdapter } from "apostil/adapters/rest";
+<ApostilProvider pageId="my-page" storage={createRestAdapter("/api/my-comments")}>
+```
+
+### Custom Adapter
+
+```tsx
+const myAdapter: ApostilStorage = {
+  async load(pageId) { /* return threads */ },
+  async save(pageId, threads) { /* persist */ },
+};
+```
+
+## Target Detection
+
+Apostil auto-detects meaningful elements when placing comments:
+
+1. `data-comment-target="id"` — explicit anchor
+2. Elements with `id` or `aria-label`
+3. Semantic HTML (`section`, `nav`, `aside`)
+4. Visual panels (scrollable, bordered, shadowed)
+
+Pins are stored as percentages relative to the target — they follow on scroll/resize.
+
+## Debug
+
+```js
+// Browser console
+__apostil_debug.enable()
+__apostil_debug.disable()
+```
+
+## Requirements
+
+- React 18+
+- Next.js (App Router)
+- Tailwind CSS
+- lucide-react
+
+## License
+
+MIT

package/bin/apostil.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import("../dist/cli/index.js");

package/dist/adapters/localStorage.d.ts

@@ -0,0 +1,5 @@
+import { A as ApostilStorage } from '../types-oQRt3lYH.js';
+
+declare const localStorageAdapter: ApostilStorage;
+
+export { localStorageAdapter };

package/dist/adapters/localStorage.js

@@ -0,0 +1,23 @@
+"use client";
+
+// src/adapters/localStorage.ts
+var STORAGE_PREFIX = "apostil-";
+var localStorageAdapter = {
+  async load(pageId) {
+    if (typeof window === "undefined") return [];
+    try {
+      const raw = localStorage.getItem(`${STORAGE_PREFIX}${pageId}`);
+      return raw ? JSON.parse(raw) : [];
+    } catch {
+      return [];
+    }
+  },
+  async save(pageId, threads) {
+    if (typeof window === "undefined") return;
+    localStorage.setItem(`${STORAGE_PREFIX}${pageId}`, JSON.stringify(threads));
+  }
+};
+export {
+  localStorageAdapter
+};
+//# sourceMappingURL=localStorage.js.map

package/dist/adapters/localStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/localStorage.ts"],"sourcesContent":["import type { ApostilStorage, ApostilThread } from \"../types\";\n\nconst STORAGE_PREFIX = \"apostil-\";\n\nexport const localStorageAdapter: ApostilStorage = {\n  async load(pageId: string): Promise<ApostilThread[]> {\n    if (typeof window === \"undefined\") return [];\n    try {\n      const raw = localStorage.getItem(`${STORAGE_PREFIX}${pageId}`);\n      return raw ? JSON.parse(raw) : [];\n    } catch {\n      return [];\n    }\n  },\n\n  async save(pageId: string, threads: ApostilThread[]): Promise<void> {\n    if (typeof window === \"undefined\") return;\n    localStorage.setItem(`${STORAGE_PREFIX}${pageId}`, JSON.stringify(threads));\n  },\n};\n"],"mappings":";;;AAEA,IAAM,iBAAiB;AAEhB,IAAM,sBAAsC;AAAA,EACjD,MAAM,KAAK,QAA0C;AACnD,QAAI,OAAO,WAAW,YAAa,QAAO,CAAC;AAC3C,QAAI;AACF,YAAM,MAAM,aAAa,QAAQ,GAAG,cAAc,GAAG,MAAM,EAAE;AAC7D,aAAO,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;AAAA,IAClC,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AAAA,EAEA,MAAM,KAAK,QAAgB,SAAyC;AAClE,QAAI,OAAO,WAAW,YAAa;AACnC,iBAAa,QAAQ,GAAG,cAAc,GAAG,MAAM,IAAI,KAAK,UAAU,OAAO,CAAC;AAAA,EAC5E;AACF;","names":[]}

package/dist/adapters/nextjs.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Next.js API route handler for apostil comment storage.
+ * Stores comments as JSON files in the project's .apostil/ directory.
+ *
+ * Usage:
+ *
+ * // app/api/apostil/route.ts
+ * export { GET, POST } from "apostil/adapters/nextjs";
+ *
+ * Or with custom directory:
+ * import { createNextjsHandler } from "apostil/adapters/nextjs";
+ * const { GET, POST } = createNextjsHandler(".my-comments");
+ * export { GET, POST };
+ */
+declare function createNextjsHandler(directory?: string): {
+    GET(request: Request): Promise<Response>;
+    POST(request: Request): Promise<Response>;
+};
+declare const GET: (request: Request) => Promise<Response>;
+declare const POST: (request: Request) => Promise<Response>;
+
+export { GET, POST, createNextjsHandler };

package/dist/adapters/nextjs.js

@@ -0,0 +1,75 @@
+// src/adapters/nextjs.ts
+function createNextjsHandler(directory = ".apostil") {
+  return {
+    async GET(request) {
+      const { promises: fs } = await import("fs");
+      const path = await import("path");
+      const url = new URL(request.url);
+      const pageId = url.searchParams.get("pageId");
+      const dir = path.join(process.cwd(), directory);
+      if (!pageId) {
+        try {
+          const files = await fs.readdir(dir);
+          const pages = [];
+          for (const file2 of files) {
+            if (!file2.endsWith(".json")) continue;
+            const id = file2.replace(".json", "");
+            try {
+              const data = await fs.readFile(path.join(dir, file2), "utf-8");
+              const threads = JSON.parse(data);
+              if (Array.isArray(threads) && threads.length > 0) {
+                pages.push({ pageId: id, threads });
+              }
+            } catch {
+            }
+          }
+          pages.sort((a, b) => {
+            const aLatest = Math.max(...a.threads.map((t) => new Date(t.createdAt).getTime()));
+            const bLatest = Math.max(...b.threads.map((t) => new Date(t.createdAt).getTime()));
+            return bLatest - aLatest;
+          });
+          return Response.json(pages);
+        } catch {
+          return Response.json([]);
+        }
+      }
+      const safeName = pageId.replace(/[^a-zA-Z0-9_-]/g, "");
+      const file = path.join(dir, `${safeName}.json`);
+      try {
+        const data = await fs.readFile(file, "utf-8");
+        return Response.json(JSON.parse(data));
+      } catch {
+        return Response.json([]);
+      }
+    },
+    async POST(request) {
+      const { promises: fs } = await import("fs");
+      const path = await import("path");
+      const url = new URL(request.url);
+      const pageId = url.searchParams.get("pageId");
+      if (!pageId) {
+        return Response.json({ error: "Missing pageId" }, { status: 400 });
+      }
+      const dir = path.join(process.cwd(), directory);
+      const safeName = pageId.replace(/[^a-zA-Z0-9_-]/g, "");
+      const file = path.join(dir, `${safeName}.json`);
+      try {
+        await fs.mkdir(dir, { recursive: true });
+        const threads = await request.json();
+        await fs.writeFile(file, JSON.stringify(threads, null, 2), "utf-8");
+        return Response.json({ ok: true });
+      } catch (e) {
+        return Response.json({ error: String(e) }, { status: 500 });
+      }
+    }
+  };
+}
+var defaultHandler = createNextjsHandler();
+var GET = defaultHandler.GET;
+var POST = defaultHandler.POST;
+export {
+  GET,
+  POST,
+  createNextjsHandler
+};
+//# sourceMappingURL=nextjs.js.map

package/dist/adapters/nextjs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/nextjs.ts"],"sourcesContent":["/**\n * Next.js API route handler for apostil comment storage.\n * Stores comments as JSON files in the project's .apostil/ directory.\n *\n * Usage:\n *\n * // app/api/apostil/route.ts\n * export { GET, POST } from \"apostil/adapters/nextjs\";\n *\n * Or with custom directory:\n * import { createNextjsHandler } from \"apostil/adapters/nextjs\";\n * const { GET, POST } = createNextjsHandler(\".my-comments\");\n * export { GET, POST };\n */\n\nexport function createNextjsHandler(directory: string = \".apostil\") {\n  return {\n    async GET(request: Request) {\n      const { promises: fs } = await import(\"fs\");\n      const path = await import(\"path\");\n\n      const url = new URL(request.url);\n      const pageId = url.searchParams.get(\"pageId\");\n      const dir = path.join(process.cwd(), directory);\n\n      // If no pageId, return ALL comments across all pages\n      if (!pageId) {\n        try {\n          const files = await fs.readdir(dir);\n          const pages: { pageId: string; threads: unknown[] }[] = [];\n          for (const file of files) {\n            if (!file.endsWith(\".json\")) continue;\n            const id = file.replace(\".json\", \"\");\n            try {\n              const data = await fs.readFile(path.join(dir, file), \"utf-8\");\n              const threads = JSON.parse(data);\n              if (Array.isArray(threads) && threads.length > 0) {\n                pages.push({ pageId: id, threads });\n              }\n            } catch {}\n          }\n          pages.sort((a, b) => {\n            const aLatest = Math.max(...(a.threads as Array<{ createdAt: string }>).map((t) => new Date(t.createdAt).getTime()));\n            const bLatest = Math.max(...(b.threads as Array<{ createdAt: string }>).map((t) => new Date(t.createdAt).getTime()));\n            return bLatest - aLatest;\n          });\n          return Response.json(pages);\n        } catch {\n          return Response.json([]);\n        }\n      }\n\n      // Single page\n      const safeName = pageId.replace(/[^a-zA-Z0-9_-]/g, \"\");\n      const file = path.join(dir, `${safeName}.json`);\n      try {\n        const data = await fs.readFile(file, \"utf-8\");\n        return Response.json(JSON.parse(data));\n      } catch {\n        return Response.json([]);\n      }\n    },\n\n    async POST(request: Request) {\n      const { promises: fs } = await import(\"fs\");\n      const path = await import(\"path\");\n\n      const url = new URL(request.url);\n      const pageId = url.searchParams.get(\"pageId\");\n      if (!pageId) {\n        return Response.json({ error: \"Missing pageId\" }, { status: 400 });\n      }\n\n      const dir = path.join(process.cwd(), directory);\n      const safeName = pageId.replace(/[^a-zA-Z0-9_-]/g, \"\");\n      const file = path.join(dir, `${safeName}.json`);\n\n      try {\n        await fs.mkdir(dir, { recursive: true });\n        const threads = await request.json();\n        await fs.writeFile(file, JSON.stringify(threads, null, 2), \"utf-8\");\n        return Response.json({ ok: true });\n      } catch (e) {\n        return Response.json({ error: String(e) }, { status: 500 });\n      }\n    },\n  };\n}\n\n// Default handler with \".apostil\" directory\nconst defaultHandler = createNextjsHandler();\nexport const GET = defaultHandler.GET;\nexport const POST = defaultHandler.POST;\n"],"mappings":"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","names":["file"]}

package/dist/adapters/rest.d.ts

@@ -0,0 +1,9 @@
+import { A as ApostilStorage } from '../types-oQRt3lYH.js';
+
+/**
+ * REST API storage adapter.
+ * Works with any backend that implements GET/POST for threads.
+ */
+declare function createRestAdapter(baseUrl: string): ApostilStorage;
+
+export { createRestAdapter };

package/dist/adapters/rest.js

@@ -0,0 +1,8 @@
+"use client";
+import {
+  createRestAdapter
+} from "../chunk-ASP7WAEG.js";
+export {
+  createRestAdapter
+};
+//# sourceMappingURL=rest.js.map

package/dist/adapters/rest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-ASP7WAEG.js

@@ -0,0 +1,42 @@
+"use client";
+
+// src/adapters/rest.ts
+function createRestAdapter(baseUrl) {
+  return {
+    async load(pageId) {
+      const url = `${baseUrl}?pageId=${encodeURIComponent(pageId)}`;
+      try {
+        const res = await fetch(url);
+        if (!res.ok) {
+          console.warn(`[apostil] load failed: ${res.status} ${res.statusText} \u2014 ${url}`);
+          return [];
+        }
+        const data = await res.json();
+        return data;
+      } catch (e) {
+        console.warn(`[apostil] load error:`, e, `\u2014 ${url}`);
+        return [];
+      }
+    },
+    async save(pageId, threads) {
+      const url = `${baseUrl}?pageId=${encodeURIComponent(pageId)}`;
+      try {
+        const res = await fetch(url, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(threads)
+        });
+        if (!res.ok) {
+          console.warn(`[apostil] save failed: ${res.status} ${res.statusText} \u2014 ${url}`);
+        }
+      } catch (e) {
+        console.warn(`[apostil] save error:`, e, `\u2014 ${url}`);
+      }
+    }
+  };
+}
+
+export {
+  createRestAdapter
+};
+//# sourceMappingURL=chunk-ASP7WAEG.js.map

package/dist/chunk-ASP7WAEG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/rest.ts"],"sourcesContent":["import type { ApostilStorage, ApostilThread } from \"../types\";\n\n/**\n * REST API storage adapter.\n * Works with any backend that implements GET/POST for threads.\n */\nexport function createRestAdapter(baseUrl: string): ApostilStorage {\n  return {\n    async load(pageId: string): Promise<ApostilThread[]> {\n      const url = `${baseUrl}?pageId=${encodeURIComponent(pageId)}`;\n      try {\n        const res = await fetch(url);\n        if (!res.ok) {\n          console.warn(`[apostil] load failed: ${res.status} ${res.statusText} — ${url}`);\n          return [];\n        }\n        const data = await res.json();\n        return data;\n      } catch (e) {\n        console.warn(`[apostil] load error:`, e, `— ${url}`);\n        return [];\n      }\n    },\n\n    async save(pageId: string, threads: ApostilThread[]): Promise<void> {\n      const url = `${baseUrl}?pageId=${encodeURIComponent(pageId)}`;\n      try {\n        const res = await fetch(url, {\n          method: \"POST\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify(threads),\n        });\n        if (!res.ok) {\n          console.warn(`[apostil] save failed: ${res.status} ${res.statusText} — ${url}`);\n        }\n      } catch (e) {\n        console.warn(`[apostil] save error:`, e, `— ${url}`);\n      }\n    },\n  };\n}\n"],"mappings":";;;AAMO,SAAS,kBAAkB,SAAiC;AACjE,SAAO;AAAA,IACL,MAAM,KAAK,QAA0C;AACnD,YAAM,MAAM,GAAG,OAAO,WAAW,mBAAmB,MAAM,CAAC;AAC3D,UAAI;AACF,cAAM,MAAM,MAAM,MAAM,GAAG;AAC3B,YAAI,CAAC,IAAI,IAAI;AACX,kBAAQ,KAAK,0BAA0B,IAAI,MAAM,IAAI,IAAI,UAAU,WAAM,GAAG,EAAE;AAC9E,iBAAO,CAAC;AAAA,QACV;AACA,cAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,eAAO;AAAA,MACT,SAAS,GAAG;AACV,gBAAQ,KAAK,yBAAyB,GAAG,UAAK,GAAG,EAAE;AACnD,eAAO,CAAC;AAAA,MACV;AAAA,IACF;AAAA,IAEA,MAAM,KAAK,QAAgB,SAAyC;AAClE,YAAM,MAAM,GAAG,OAAO,WAAW,mBAAmB,MAAM,CAAC;AAC3D,UAAI;AACF,cAAM,MAAM,MAAM,MAAM,KAAK;AAAA,UAC3B,QAAQ;AAAA,UACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,UAC9C,MAAM,KAAK,UAAU,OAAO;AAAA,QAC9B,CAAC;AACD,YAAI,CAAC,IAAI,IAAI;AACX,kBAAQ,KAAK,0BAA0B,IAAI,MAAM,IAAI,IAAI,UAAU,WAAM,GAAG,EAAE;AAAA,QAChF;AAAA,MACF,SAAS,GAAG;AACV,gBAAQ,KAAK,yBAAyB,GAAG,UAAK,GAAG,EAAE;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/index.js

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+
+// src/cli/index.ts
+import fs from "fs/promises";
+import path from "path";
+var args = process.argv.slice(2);
+var command = args[0];
+if (command === "init") {
+  init();
+} else if (command === "remove") {
+  remove();
+} else if (command === "help" || command === "--help" || command === "-h" || !command) {
+  printHelp();
+} else {
+  console.log(`  Unknown command: ${command}
+`);
+  printHelp();
+}
+function printHelp() {
+  console.log(`
+  apostil \u2014 Pin-and-comment feedback for React & Next.js
+
+  Usage:
+    npx apostil init      Set up apostil in your Next.js project
+    npx apostil remove    Remove apostil from your project
+    npx apostil help      Show this help
+`);
+}
+async function init() {
+  const cwd = process.cwd();
+  const appDir = await findAppDir(cwd);
+  if (!appDir) {
+    console.log("  Could not find a Next.js app/ directory.");
+    console.log("  Make sure you're running this from your project root.\n");
+    process.exit(1);
+  }
+  const useSrc = appDir.includes("src/app");
+  console.log("\n  Setting up apostil...\n");
+  const apiDir = path.join(appDir, "api", "apostil");
+  const apiFile = path.join(apiDir, "route.ts");
+  if (await fileExists(apiFile)) {
+    console.log("  \u2713 API route already exists");
+  } else {
+    await fs.mkdir(apiDir, { recursive: true });
+    await fs.writeFile(
+      apiFile,
+      `export { GET, POST } from "apostil/adapters/nextjs";
+`,
+      "utf-8"
+    );
+    console.log("  \u2713 Created ${rel(cwd, apiFile)}");
+  }
+  const componentsDir = path.join(cwd, useSrc ? "src/components" : "components");
+  const wrapperFile = path.join(componentsDir, "apostil-wrapper.tsx");
+  if (await fileExists(wrapperFile)) {
+    console.log("  \u2713 Wrapper component already exists");
+  } else {
+    await fs.mkdir(componentsDir, { recursive: true });
+    await fs.writeFile(wrapperFile, getWrapperComponent(), "utf-8");
+    console.log(`  \u2713 Created ${rel(cwd, wrapperFile)}`);
+  }
+  const commentsDir = path.join(cwd, ".apostil");
+  await fs.mkdir(commentsDir, { recursive: true });
+  console.log("  \u2713 Created .apostil/ directory");
+  const gitignorePath = path.join(cwd, ".gitignore");
+  let gitignore = "";
+  try {
+    gitignore = await fs.readFile(gitignorePath, "utf-8");
+  } catch {
+  }
+  if (!gitignore.includes(".apostil")) {
+    const entry = "\n# Apostil comments\n.apostil/\n";
+    await fs.appendFile(gitignorePath, entry, "utf-8");
+    console.log("  \u2713 Added .apostil/ to .gitignore");
+  } else {
+    console.log("  \u2713 .gitignore already configured");
+  }
+  const layoutInjected = await injectIntoLayout(appDir, useSrc);
+  if (layoutInjected) {
+    console.log(`  \u2713 Added <ApostilWrapper> to root layout`);
+  }
+  console.log("\n  Done! Run your dev server and press C to start commenting.\n");
+}
+async function remove() {
+  const cwd = process.cwd();
+  const appDir = await findAppDir(cwd);
+  const useSrc = appDir?.includes("src/app") ?? false;
+  console.log("\n  Removing apostil...\n");
+  if (appDir) {
+    const apiDir = path.join(appDir, "api", "apostil");
+    if (await fileExists(path.join(apiDir, "route.ts"))) {
+      await fs.rm(apiDir, { recursive: true });
+      console.log("  \u2713 Removed API route");
+    }
+  }
+  const componentsDir = path.join(cwd, useSrc ? "src/components" : "components");
+  const wrapperFile = path.join(componentsDir, "apostil-wrapper.tsx");
+  if (await fileExists(wrapperFile)) {
+    await fs.rm(wrapperFile);
+    console.log("  \u2713 Removed wrapper component");
+  }
+  if (appDir) {
+    const unwrapped = await removeFromLayout(appDir);
+    if (unwrapped) {
+      console.log("  \u2713 Removed <ApostilWrapper> from root layout");
+    }
+  }
+  const commentsDir = path.join(cwd, ".apostil");
+  if (await fileExists(commentsDir)) {
+    await fs.rm(commentsDir, { recursive: true });
+    console.log("  \u2713 Removed .apostil/ directory");
+  }
+  const gitignorePath = path.join(cwd, ".gitignore");
+  try {
+    let gitignore = await fs.readFile(gitignorePath, "utf-8");
+    gitignore = gitignore.replace(/\n?# Apostil comments\n\.apostil\/\n?/g, "");
+    await fs.writeFile(gitignorePath, gitignore, "utf-8");
+    console.log("  \u2713 Cleaned .gitignore");
+  } catch {
+  }
+  console.log(`
+  Done! Now run: npm uninstall apostil
+`);
+}
+function getWrapperComponent() {
+  return `"use client";
+
+import { usePathname } from "next/navigation";
+import {
+  ApostilProvider,
+  CommentOverlay,
+  CommentToggle,
+  CommentSidebar,
+} from "apostil";
+
+export function ApostilWrapper({ children }: { children: React.ReactNode }) {
+  const pathname = usePathname();
+  const pageId = pathname.replace(/\\//g, "--").replace(/^--/, "") || "home";
+
+  return (
+    <ApostilProvider pageId={pageId}>
+      {children}
+      <CommentOverlay />
+      <CommentSidebar />
+      <CommentToggle />
+    </ApostilProvider>
+  );
+}
+`;
+}
+async function injectIntoLayout(appDir, useSrc) {
+  const layoutPath = await findLayout(appDir);
+  if (!layoutPath) return false;
+  let content = await fs.readFile(layoutPath, "utf-8");
+  if (content.includes("ApostilWrapper")) {
+    console.log("  \u2713 Layout already has <ApostilWrapper>");
+    return false;
+  }
+  const importPath = useSrc ? "@/components/apostil-wrapper" : "../components/apostil-wrapper";
+  const importLine = `import { ApostilWrapper } from "${importPath}";
+`;
+  const importRegex = /^import\s.+$/gm;
+  let lastImportIndex = 0;
+  let match;
+  while ((match = importRegex.exec(content)) !== null) {
+    lastImportIndex = match.index + match[0].length;
+  }
+  if (lastImportIndex > 0) {
+    content = content.slice(0, lastImportIndex) + "\n" + importLine + content.slice(lastImportIndex);
+  } else {
+    const useDirective = content.match(/^["']use (client|server)["'];?\n/);
+    const insertAt = useDirective ? useDirective[0].length : 0;
+    content = content.slice(0, insertAt) + importLine + content.slice(insertAt);
+  }
+  const bodyChildrenRegex = /(<body[^>]*>)([\s\S]*?)(\{[\s]*children[\s]*\})([\s\S]*?)(<\/body>)/;
+  const bodyMatch = content.match(bodyChildrenRegex);
+  if (bodyMatch) {
+    content = content.replace(
+      bodyChildrenRegex,
+      `$1$2<ApostilWrapper>$3</ApostilWrapper>$4$5`
+    );
+  } else {
+    const childrenRegex = /(\{[\s]*children[\s]*\})/;
+    if (childrenRegex.test(content)) {
+      content = content.replace(childrenRegex, `<ApostilWrapper>$1</ApostilWrapper>`);
+    } else {
+      console.log("  \u26A0 Could not find {children} in layout \u2014 add <ApostilWrapper> manually");
+      return false;
+    }
+  }
+  await fs.writeFile(layoutPath, content, "utf-8");
+  return true;
+}
+async function removeFromLayout(appDir) {
+  const layoutPath = await findLayout(appDir);
+  if (!layoutPath) return false;
+  let content = await fs.readFile(layoutPath, "utf-8");
+  if (!content.includes("ApostilWrapper")) return false;
+  content = content.replace(/import\s*\{[^}]*ApostilWrapper[^}]*\}\s*from\s*["'][^"']+["'];?\n?/g, "");
+  content = content.replace(/<ApostilWrapper>([\s\S]*?)<\/ApostilWrapper>/g, "$1");
+  await fs.writeFile(layoutPath, content, "utf-8");
+  return true;
+}
+async function findAppDir(cwd) {
+  for (const candidate of ["src/app", "app"]) {
+    const dir = path.join(cwd, candidate);
+    try {
+      const stat = await fs.stat(dir);
+      if (stat.isDirectory()) return dir;
+    } catch {
+    }
+  }
+  return null;
+}
+async function findLayout(appDir) {
+  for (const ext of ["tsx", "jsx", "ts", "js"]) {
+    const file = path.join(appDir, `layout.${ext}`);
+    if (await fileExists(file)) return file;
+  }
+  return null;
+}
+async function fileExists(p) {
+  try {
+    await fs.stat(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function rel(cwd, filePath) {
+  return path.relative(cwd, filePath);
+}
+//# sourceMappingURL=index.js.map