vite-plugin-agentation-vue 0.0.2

package/LICENSE

@@ -0,0 +1,27 @@
+PolyForm Shield License 1.0.0
+
+Copyright (c) 2026 Benji Taylor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use,
+copy, modify, and distribute the Software, subject to the following conditions:
+
+1. You may not use the Software to provide a product or service that competes
+   with the Software or any product or service offered by the Licensor that
+   includes the Software.
+
+2. You may not remove or obscure any licensing, copyright, or other notices
+   included in the Software.
+
+3. If you distribute the Software or any derivative works, you must include a
+   copy of this license.
+
+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.
+
+For more information, see https://polyformproject.org/licenses/shield/1.0.0

package/README.md

@@ -0,0 +1,116 @@
+# vite-plugin-agentation-vue
+
+Vite plugin for one-line setup of `agentation-vue`.
+
+It injects the Vue annotation overlay in dev mode and wires source resolution
+through `vite-plugin-vue-tracer` so exported feedback can include component
+file and line information.
+
+## Installation
+
+```bash
+pnpm add -D vite-plugin-agentation-vue
+```
+
+## Setup
+
+```ts
+// vite.config.ts
+import vue from "@vitejs/plugin-vue"
+import { agentation } from "vite-plugin-agentation-vue"
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    agentation(),  // Must come after vue()
+  ],
+})
+```
+
+The plugin automatically injects the annotation overlay in dev mode. It's disabled during production builds.
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `enabled` | `boolean` | `true` in dev | Enable/disable the plugin |
+| `locale` | `"en" \| "zh-CN"` | `"en"` | Default UI locale |
+| `storagePrefix` | `string` | `"agentation-vue-"` | localStorage key prefix |
+| `outputDetail` | `"compact" \| "standard" \| "detailed" \| "forensic"` | `"standard"` | Level of detail in export output |
+| `sync` | `{ endpoint: string, autoSync?: boolean, debounceMs?: number } \| false` | `false` | MCP server sync configuration |
+| `inspector` | `"tracer"` | `"tracer"` | Source resolution strategy |
+
+## Sync Configuration
+
+To sync annotations to an MCP server:
+
+```ts
+agentation({
+  sync: {
+    endpoint: "http://localhost:4747",
+    autoSync: true,     // default
+    debounceMs: 400,    // default
+  },
+})
+```
+
+## Nuxt Setup
+
+Nuxt also needs a client-only bootstrap plugin:
+
+```ts
+// plugins/agentation.client.ts
+export default defineNuxtPlugin(() => {
+  onNuxtReady(async () => {
+    await import("virtual:agentation")
+  })
+})
+```
+
+See `playgrounds/nuxt-demo` in the repository for a complete example.
+
+```ts
+// nuxt.config.ts
+import { agentation } from "vite-plugin-agentation-vue"
+
+export default defineNuxtConfig({
+  vite: {
+    plugins: [agentation()],
+  },
+})
+```
+
+## CSS Variables
+
+The overlay uses CSS custom properties that can be customized:
+
+| Variable | Dark Mode | Light Mode | Description |
+|----------|-----------|------------|-------------|
+| `--ag-bg` | `#1e293b` | `#ffffff` | Base background |
+| `--ag-bg-surface` | `rgba(30,41,59,0.96)` | `rgba(255,255,255,0.96)` | Surface background |
+| `--ag-bg-elevated` | `rgba(15,23,42,0.72)` | `rgba(241,245,249,0.72)` | Elevated background |
+| `--ag-text` | `#e2e8f0` | `#1e293b` | Text color |
+| `--ag-muted` | `#94a3b8` | `#64748b` | Muted text |
+| `--ag-border` | `rgba(148,163,184,0.24)` | `rgba(148,163,184,0.3)` | Border color |
+| `--ag-accent` | `#3b82f6` | `#3b82f6` | Accent (blue) |
+| `--ag-selected` | `#f59e0b` | `#f59e0b` | Selection (amber) |
+
+## Keyboard Shortcuts
+
+| Shortcut | Action |
+|----------|--------|
+| `Cmd/Ctrl+Shift+F` | Toggle annotation mode |
+| `P` | Pause or resume animations |
+| `H` | Hide or show markers |
+| `C` | Copy Markdown |
+| `X` | Clear all annotations |
+| `Escape` | Dismiss popover / deselect / disable annotation mode |
+
+## Release Flow
+
+Workspace versions are managed from the repository root with `bumpp`.
+
+
+## License
+
+PolyForm Shield 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * vite-plugin-agentation-vue
+ *
+ * One-line Vite plugin for Vue 3 page annotation in dev mode.
+ * Internally composes vite-plugin-vue-tracer for source position recording.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import vue from '@vitejs/plugin-vue'
+ * import agentation from 'vite-plugin-agentation-vue'
+ *
+ * export default defineConfig({
+ *   plugins: [vue(), agentation()]
+ * })
+ * ```
+ */
+export { agentation, agentationVue } from "./plugin.js";
+export { agentation as default } from "./plugin.js";
+export type { AgentationVueOptions, AgentationVuePluginOptions, AgentationVueSyncOptions, ResolvedAgentationVueOptions, } from "./types.js";
+export { resolveElementSource, bindTracer } from "./runtime/resolver/index.js";
+export type { SourceLocation, FrameworkKind } from "@liuovo/agentation-vue-core";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAGnD,YAAY,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAC9E,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * vite-plugin-agentation-vue
+ *
+ * One-line Vite plugin for Vue 3 page annotation in dev mode.
+ * Internally composes vite-plugin-vue-tracer for source position recording.
+ *
+ * @example
+ * ```ts
+ * // vite.config.ts
+ * import vue from '@vitejs/plugin-vue'
+ * import agentation from 'vite-plugin-agentation-vue'
+ *
+ * export default defineConfig({
+ *   plugins: [vue(), agentation()]
+ * })
+ * ```
+ */
+// Plugin factory (primary export)
+export { agentation, agentationVue } from "./plugin.js";
+export { agentation as default } from "./plugin.js";
+// Resolver API — usable independently of the full plugin
+export { resolveElementSource, bindTracer } from "./runtime/resolver/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,kCAAkC;AAClC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,aAAa,CAAA;AAUnD,yDAAyD;AACzD,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/plugin.d.ts

@@ -0,0 +1,28 @@
+import type { Plugin } from "vite";
+import { type AgentationVueOptions } from "./types.js";
+/**
+ * Agentation-Vue plugin factory.
+ *
+ * Returns an array of Vite plugins:
+ * 1. The agentation shell plugin (virtual module + runtime injection)
+ * 2. The `vite-plugin-vue-tracer` plugin (source position recording)
+ *
+ * Usage:
+ * ```ts
+ * // vite.config.ts
+ * import vue from '@vitejs/plugin-vue'
+ * import agentation from 'vite-plugin-agentation-vue'
+ *
+ * export default defineConfig({
+ *   plugins: [vue(), agentation()]
+ * })
+ * ```
+ *
+ * **Important:** `agentation()` must be registered after `vue()` so that
+ * tracer transforms run after Vue SFC compilation.
+ */
+export declare function agentation(options?: AgentationVueOptions): Plugin[];
+/** @deprecated Use {@link agentation} instead */
+export declare const agentationVue: typeof agentation;
+export default agentation;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AAElC,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAA;AA0ItE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,EAAE,CAYvE;AAED,iDAAiD;AACjD,eAAO,MAAM,aAAa,mBAAa,CAAA;AAEvC,eAAe,UAAU,CAAA"}

package/dist/plugin.js

@@ -0,0 +1,155 @@
+import VueTracer from "vite-plugin-vue-tracer";
+import { resolveOptions } from "./types.js";
+import { INIT_SCRIPT_PATH, createInitModuleSource, createInjectionTag, loadVirtualModule, resolveVirtualId, } from "./virtual.js";
+// ---------------------------------------------------------------------------
+// Terminal logging (ANSI colors + ASCII art)
+// ---------------------------------------------------------------------------
+const c = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    cyan: "\x1b[36m",
+    magenta: "\x1b[35m",
+};
+const PREFIX = `${c.bold}${c.cyan}🛰  agentation${c.reset}`;
+function printBanner(options) {
+    const status = options.enabled === false
+        ? `${c.bold}${c.yellow}DISABLED${c.reset}`
+        : `${c.bold}${c.green}AUTO${c.reset} ${c.dim}(active in serve mode)${c.reset}`;
+    console.log([
+        "",
+        `${c.magenta}   ╔═══════════════════════════════╗${c.reset}`,
+        `${c.magenta}   ║${c.reset}  ${c.bold}${c.cyan}🛰  agentation-vue${c.reset}            ${c.magenta}║${c.reset}`,
+        `${c.magenta}   ║${c.reset}  ${c.dim}vite plugin loaded${c.reset}             ${c.magenta}║${c.reset}`,
+        `${c.magenta}   ╚═══════════════════════════════╝${c.reset}`,
+        `   ${c.dim}status:${c.reset} ${status}  ✨`,
+        "",
+    ].join("\n"));
+}
+function logTerm(message, detail) {
+    const d = detail ? ` ${c.dim}(${detail})${c.reset}` : "";
+    console.log(`  ${PREFIX} ${c.green}${message}${c.reset}${d}`);
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Recursively flattens a Vite plugin value (single plugin, array, or falsy)
+ * into a flat array of Plugin objects.
+ */
+function flattenPlugins(input) {
+    if (Array.isArray(input))
+        return input.flatMap(flattenPlugins);
+    if (input && typeof input === "object" && "name" in input)
+        return [input];
+    return [];
+}
+/**
+ * Wraps a plugin so it only runs during `serve` (dev mode).
+ * This ensures the internally-composed VueTracer plugin never activates in build.
+ */
+function serveOnly(plugin) {
+    return {
+        ...plugin,
+        apply(config, env) {
+            if (env.command !== "serve")
+                return false;
+            const original = plugin.apply;
+            if (original == null || original === "serve")
+                return true;
+            if (original === "build")
+                return false;
+            return original(config, env);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Plugin factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates the main agentation Vite plugin.
+ *
+ * Responsibilities:
+ * - Resolves & serves the `virtual:agentation` module
+ * - Injects the runtime bootstrap `<script>` into the HTML
+ * - Only active during `vite dev` (command === "serve")
+ */
+function createShellPlugin(options) {
+    let resolved = resolveOptions(options, "build");
+    return {
+        name: "vite-plugin-agentation-vue",
+        enforce: "pre",
+        apply: "serve",
+        configResolved(config) {
+            resolved = resolveOptions(options, config.command);
+            logTerm(resolved.enabled ? "configResolved ✅" : "configResolved ⏸️  plugin disabled", `command=${config.command}`);
+        },
+        configureServer(server) {
+            server.middlewares.use((req, res, next) => {
+                if (!resolved.enabled)
+                    return next();
+                const url = req.url?.split("?", 1)[0];
+                if (url !== INIT_SCRIPT_PATH)
+                    return next();
+                logTerm("init module served 🚀", INIT_SCRIPT_PATH);
+                res.statusCode = 200;
+                res.setHeader("Content-Type", "text/javascript; charset=utf-8");
+                res.setHeader("Cache-Control", "no-cache");
+                res.end(createInitModuleSource(resolved));
+            });
+        },
+        resolveId(id) {
+            if (!resolved.enabled)
+                return;
+            return resolveVirtualId(id);
+        },
+        load(id) {
+            if (!resolved.enabled)
+                return;
+            return loadVirtualModule(id, resolved);
+        },
+        transformIndexHtml() {
+            if (!resolved.enabled)
+                return;
+            logTerm("transformIndexHtml 🧩", "injecting runtime <script src> into HTML");
+            return [createInjectionTag()];
+        },
+    };
+}
+/**
+ * Agentation-Vue plugin factory.
+ *
+ * Returns an array of Vite plugins:
+ * 1. The agentation shell plugin (virtual module + runtime injection)
+ * 2. The `vite-plugin-vue-tracer` plugin (source position recording)
+ *
+ * Usage:
+ * ```ts
+ * // vite.config.ts
+ * import vue from '@vitejs/plugin-vue'
+ * import agentation from 'vite-plugin-agentation-vue'
+ *
+ * export default defineConfig({
+ *   plugins: [vue(), agentation()]
+ * })
+ * ```
+ *
+ * **Important:** `agentation()` must be registered after `vue()` so that
+ * tracer transforms run after Vue SFC compilation.
+ */
+export function agentation(options = {}) {
+    printBanner(options);
+    const shell = createShellPlugin(options);
+    // When explicitly disabled, return only the shell (which is a no-op)
+    if (options.enabled === false)
+        return [shell];
+    // Compose vue-tracer plugins, restricting them to dev mode only
+    const tracerPlugins = flattenPlugins(VueTracer()).map(serveOnly);
+    return [shell, ...tracerPlugins];
+}
+/** @deprecated Use {@link agentation} instead */
+export const agentationVue = agentation;
+export default agentation;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/dist/runtime/bootstrap.d.ts

@@ -0,0 +1,27 @@
+import type { SourceLocation } from "@liuovo/agentation-vue-core";
+import type { AnnotationsStore, AreaSelectionState, SelectionState, SettingsState, UiNotification } from "@liuovo/agentation-vue-ui";
+import type { AgentationStorageBridge } from "../types.js";
+export interface RuntimeInfrastructure {
+    appRoot: HTMLDivElement;
+    overlayRoot: HTMLDivElement;
+    storage: AgentationStorageBridge;
+    resolveSource(el: HTMLElement): SourceLocation | null;
+}
+/**
+ * Creates the DOM containers and storage bridge.
+ * Does NOT register event listeners — that's done in `attachListeners()`.
+ */
+export declare function setupInfrastructure(storagePrefix: string): RuntimeInfrastructure;
+export interface ListenerCleanup {
+    dispose(): void;
+}
+/**
+ * Registers pointer/click event listeners that drive Vue selection state.
+ *
+ * Handles:
+ * - Single-click element selection
+ * - Drag-to-select area selection (like React's multi-select)
+ * - `blockInteractions` setting for click interception
+ */
+export declare function attachListeners(store: AnnotationsStore, selection: SelectionState, areaSelection: AreaSelectionState, settings: SettingsState, resolveSource: (el: HTMLElement) => SourceLocation | null, notify?: (notification: UiNotification) => void): ListenerCleanup;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/runtime/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/runtime/bootstrap.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAgB,cAAc,EAAkB,MAAM,6BAA6B,CAAA;AAC/F,OAAO,KAAK,EACV,gBAAgB,EAGhB,kBAAkB,EAElB,cAAc,EACd,aAAa,EACb,cAAc,EACf,MAAM,2BAA2B,CAAA;AAElC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAA;AA8B1D,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,cAAc,CAAA;IACvB,WAAW,EAAE,cAAc,CAAA;IAC3B,OAAO,EAAE,uBAAuB,CAAA;IAChC,aAAa,CAAC,EAAE,EAAE,WAAW,GAAG,cAAc,GAAG,IAAI,CAAA;CACtD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,GACpB,qBAAqB,CAcvB;AAMD,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,IAAI,CAAA;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,cAAc,EACzB,aAAa,EAAE,kBAAkB,EACjC,QAAQ,EAAE,aAAa,EACvB,aAAa,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,cAAc,GAAG,IAAI,EACzD,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,cAAc,KAAK,IAAI,GAC9C,eAAe,CAuOjB"}