dev-annotate 0.1.0 → 0.2.1

package/README.md

@@ -38,7 +38,7 @@ injected DOM and listeners.
 
 ```ts
 import { createSaveAnnotationHandler } from 'dev-annotate/server'
-export default createSaveAnnotationHandler({ dir: '.playwright-mcp/design-review' })
+export default createSaveAnnotationHandler({ dir: '.dev-annotations' })
 ```
 
 Or use the pure writer directly:

package/dist/cli.js

@@ -25,7 +25,7 @@ function latestAnnotation(dir) {
 // src/server/save.ts
 import { mkdirSync, writeFileSync } from "fs";
 import { resolve } from "path";
-var DEFAULT_DIR = ".playwright-mcp/design-review";
+var DEFAULT_DIR = ".dev-annotations";
 
 // src/cli/index.ts
 function parseFlags(args) {

package/dist/core/client.js

@@ -13,11 +13,11 @@ var DEFAULTS = {
 
 // src/core/client.ts
 function initDevAnnotation(options = {}) {
-  const endpoint = options.endpoint ?? DEFAULTS.endpoint;
-  const colors = options.colors ?? DEFAULTS.colors;
-  const sizePresets = options.sizes ?? DEFAULTS.sizes;
-  const shortcutKey = (options.shortcutKey ?? DEFAULTS.shortcutKey).toLowerCase();
-  const z = options.zIndexBase ?? DEFAULTS.zIndexBase;
+  const endpoint = typeof options.endpoint === "string" && options.endpoint ? options.endpoint : DEFAULTS.endpoint;
+  const colors = Array.isArray(options.colors) && options.colors.length ? options.colors : DEFAULTS.colors;
+  const sizePresets = Array.isArray(options.sizes) && options.sizes.length ? options.sizes : DEFAULTS.sizes;
+  const shortcutKey = (typeof options.shortcutKey === "string" && options.shortcutKey ? options.shortcutKey : DEFAULTS.shortcutKey).toLowerCase();
+  const z = typeof options.zIndexBase === "number" ? options.zIndexBase : DEFAULTS.zIndexBase;
   const nodes = [];
   const cleanups = [];
   const track = (n) => {

package/dist/nuxt/module.d.ts

@@ -1,7 +1,7 @@
 import { D as DevAnnotationOptions } from '../types-BzKl2hyk.js';
 
 interface ModuleOptions extends DevAnnotationOptions {
-    /** Server-side save directory. Default '.playwright-mcp/design-review'. */
+    /** Server-side save directory. Default '.dev-annotations'. */
     dir?: string;
 }
 declare const _default: NuxtModule<TOptions, TOptions, false>;

package/dist/nuxt/module.js

@@ -6,15 +6,15 @@ var module_default = defineNuxtModule({
   setup(options, nuxt) {
     if (!nuxt.options.dev) return;
     const resolver = createResolver(import.meta.url);
+    const publicConfig = {};
+    if (options.endpoint !== void 0) publicConfig.endpoint = options.endpoint;
+    if (options.colors !== void 0) publicConfig.colors = options.colors;
+    if (options.sizes !== void 0) publicConfig.sizes = options.sizes;
+    if (options.shortcutKey !== void 0) publicConfig.shortcutKey = options.shortcutKey;
+    if (options.zIndexBase !== void 0) publicConfig.zIndexBase = options.zIndexBase;
     nuxt.options.runtimeConfig.public = nuxt.options.runtimeConfig.public ?? {};
-    nuxt.options.runtimeConfig.public.devAnnotate = {
-      endpoint: options.endpoint,
-      colors: options.colors,
-      sizes: options.sizes,
-      shortcutKey: options.shortcutKey,
-      zIndexBase: options.zIndexBase
-    };
-    nuxt.options.runtimeConfig.devAnnotate = { dir: options.dir };
+    nuxt.options.runtimeConfig.public.devAnnotate = publicConfig;
+    nuxt.options.runtimeConfig.devAnnotate = options.dir !== void 0 ? { dir: options.dir } : {};
     addPlugin({ src: resolver.resolve("./runtime/plugin.client.js"), mode: "client" });
     addServerHandler({
       route: options.endpoint ?? "/api/dev/save-annotation",

package/dist/nuxt/runtime/plugin.client.js

@@ -16,11 +16,11 @@ var DEFAULTS = {
 
 // src/core/client.ts
 function initDevAnnotation(options = {}) {
-  const endpoint = options.endpoint ?? DEFAULTS.endpoint;
-  const colors = options.colors ?? DEFAULTS.colors;
-  const sizePresets = options.sizes ?? DEFAULTS.sizes;
-  const shortcutKey = (options.shortcutKey ?? DEFAULTS.shortcutKey).toLowerCase();
-  const z = options.zIndexBase ?? DEFAULTS.zIndexBase;
+  const endpoint = typeof options.endpoint === "string" && options.endpoint ? options.endpoint : DEFAULTS.endpoint;
+  const colors = Array.isArray(options.colors) && options.colors.length ? options.colors : DEFAULTS.colors;
+  const sizePresets = Array.isArray(options.sizes) && options.sizes.length ? options.sizes : DEFAULTS.sizes;
+  const shortcutKey = (typeof options.shortcutKey === "string" && options.shortcutKey ? options.shortcutKey : DEFAULTS.shortcutKey).toLowerCase();
+  const z = typeof options.zIndexBase === "number" ? options.zIndexBase : DEFAULTS.zIndexBase;
   const nodes = [];
   const cleanups = [];
   const track = (n) => {

package/dist/nuxt/runtime/server-route.js

@@ -12,7 +12,7 @@ function resolveExt(input) {
 // src/server/save.ts
 import { mkdirSync, writeFileSync } from "fs";
 import { resolve } from "path";
-var DEFAULT_DIR = ".playwright-mcp/design-review";
+var DEFAULT_DIR = ".dev-annotations";
 function saveAnnotationBytes(data, opts = {}) {
   const dir = resolve(process.cwd(), opts.dir ?? DEFAULT_DIR);
   mkdirSync(dir, { recursive: true });

package/dist/server/index.d.ts

@@ -14,7 +14,7 @@ interface SaveAnnotationResult {
     path: string;
     bytes: number;
 }
-declare const DEFAULT_DIR = ".playwright-mcp/design-review";
+declare const DEFAULT_DIR = ".dev-annotations";
 declare function saveAnnotationBytes(data: Uint8Array, opts?: SaveAnnotationOptions): SaveAnnotationResult;
 
 interface SaveHandlerOptions {

package/dist/server/index.js

@@ -9,7 +9,7 @@ function resolveExt(input) {
 // src/server/save.ts
 import { mkdirSync, writeFileSync } from "fs";
 import { resolve } from "path";
-var DEFAULT_DIR = ".playwright-mcp/design-review";
+var DEFAULT_DIR = ".dev-annotations";
 function saveAnnotationBytes(data, opts = {}) {
   const dir = resolve(process.cwd(), opts.dir ?? DEFAULT_DIR);
   mkdirSync(dir, { recursive: true });

package/package.json

@@ -1,36 +1,36 @@
-{
-  "name": "dev-annotate",
-  "version": "0.1.0",
-  "description": "Dev-only on-screen annotation tool: scribble on the live page, take an OS screenshot, upload it for an AI agent to read.",
-  "type": "module",
-  "license": "MIT",
-  "keywords": ["annotation", "screenshot", "dev-tool", "design-review", "ai", "nuxt"],
-  "engines": { "node": ">=20" },
-  "bin": { "dev-annotate": "dist/cli.js" },
-  "exports": {
-    ".": { "import": "./dist/core/client.js", "types": "./dist/core/client.d.ts" },
-    "./server": { "import": "./dist/server/index.js", "types": "./dist/server/index.d.ts" },
-    "./nuxt": { "import": "./dist/nuxt/module.js", "types": "./dist/nuxt/module.d.ts" }
-  },
-  "files": ["dist", "templates", "README.md", "LICENSE"],
-  "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "prepublishOnly": "tsup"
-  },
-  "peerDependencies": { "h3": "*", "@nuxt/kit": "*" },
-  "peerDependenciesMeta": {
-    "h3": { "optional": true },
-    "@nuxt/kit": { "optional": true }
-  },
-  "devDependencies": {
-    "@types/node": "^22.10.2",
-    "tsup": "^8.5.1",
-    "typescript": "^5.7.3",
-    "vitest": "^3.2.4",
-    "jsdom": "^25.0.0",
-    "h3": "^1.13.0",
-    "@nuxt/kit": "^3.14.0"
-  }
-}
+{
+  "name": "dev-annotate",
+  "version": "0.2.1",
+  "description": "Dev-only on-screen annotation tool: scribble on the live page, take an OS screenshot, upload it for an AI agent to read.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": ["annotation", "screenshot", "dev-tool", "design-review", "ai", "nuxt"],
+  "engines": { "node": ">=20" },
+  "bin": { "dev-annotate": "dist/cli.js" },
+  "exports": {
+    ".": { "import": "./dist/core/client.js", "types": "./dist/core/client.d.ts" },
+    "./server": { "import": "./dist/server/index.js", "types": "./dist/server/index.d.ts" },
+    "./nuxt": { "import": "./dist/nuxt/module.js", "types": "./dist/nuxt/module.d.ts" }
+  },
+  "files": ["dist", "templates", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "tsup"
+  },
+  "peerDependencies": { "h3": "*", "@nuxt/kit": "*" },
+  "peerDependenciesMeta": {
+    "h3": { "optional": true },
+    "@nuxt/kit": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.4",
+    "jsdom": "^25.0.0",
+    "h3": "^1.13.0",
+    "@nuxt/kit": "^3.14.0"
+  }
+}

package/templates/agent-instructions.md

@@ -25,7 +25,7 @@ annotated screenshot and act on it.
    ```
 
 ## Notes
-- Screenshots live under `.playwright-mcp/design-review/annotated-*.{png,jpg,webp}`
+- Screenshots live under `.dev-annotations/annotated-*.{png,jpg,webp}`
   by default (override with `--dir`).
 - Treat an annotation as intent, not pixels: confirm the underlying cause
   before changing how something looks.