@visulima/dev-toolbar 1.0.0-alpha.14 → 1.0.0-alpha.15

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## @visulima/dev-toolbar [1.0.0-alpha.15](https://github.com/visulima/visulima/compare/@visulima/dev-toolbar@1.0.0-alpha.14...@visulima/dev-toolbar@1.0.0-alpha.15) (2026-05-04)
+
+### Miscellaneous Chores
+
+* **dev-toolbar:** allow zod v4 and align eslint-plugin-zod with catalog ([70733ad](https://github.com/visulima/visulima/commit/70733ad6155c3bc460d2bc0943f88af59b7b6725))
+
 ## @visulima/dev-toolbar [1.0.0-alpha.14](https://github.com/visulima/visulima/compare/@visulima/dev-toolbar@1.0.0-alpha.13...@visulima/dev-toolbar@1.0.0-alpha.14) (2026-04-30)
 
 ### Miscellaneous Chores

package/dist/index.d.ts

@@ -1,54 +1,11 @@
 import { D as DevToolbarApp, T as ToolbarSettings } from "./packem_shared/app.d-SmKEDxsI.js";
 export { A as AppView, b as DEFAULT_TOOLBAR_SETTINGS, a as DevToolbarAppState, F as FrameState, N as NotificationLevel, P as PositionAnchor, S as ServerFunctions, c as ServerHelpers, d as ToolbarAppEventTarget, e as ToolbarPlacement } from "./packem_shared/app.d-SmKEDxsI.js";
-import { T as TimelineEvent, D as DevToolbarHook, C as ClientFunctions, a as ClientRPCContext, S as ServerFunctions, b as ServerRPCContext, c as TimelineGroup } from "./packem_shared/global-api.d-BLfn-OUA.js";
-export { A as AccessibilityInfo, d as Annotation, e as AnnotationIntent, f as AnnotationSeverity, g as AnnotationStatus, B as BoundingBox, h as CreateAnnotationData, i as DEFAULT_TIMELINE_GROUPS, F as FrameworkContext, H as HookEvents, j as ThreadMessage, k as TimelineEventLevel, U as UpdateAnnotationData, V as VisulimaDevTools } from "./packem_shared/global-api.d-BLfn-OUA.js";
+import { T as TimelineEvent, D as DevToolbarHook, C as ClientFunctions, a as ClientRPCContext, S as ServerFunctions, b as ServerRPCContext, c as TimelineGroup } from "./packem_shared/global-api.d-DG2WYakl.js";
+export { A as AccessibilityInfo, d as Annotation, e as AnnotationIntent, f as AnnotationSeverity, g as AnnotationStatus, B as BoundingBox, h as CreateAnnotationData, i as DEFAULT_TIMELINE_GROUPS, F as FrameworkContext, H as HookEvents, j as ThreadMessage, k as TimelineEventLevel, U as UpdateAnnotationData, V as VisulimaDevTools } from "./packem_shared/global-api.d-DG2WYakl.js";
 import { ViteDevServer } from 'vite';
 export { DevToolbar } from "./toolbar/index.js";
 import 'preact';
 /**
-* Message channel interface for bidirectional communication
-*/
-interface MessageChannel<TEvents extends Record<string, (...args: any[]) => void>> {
-  /**
-  * Unsubscribe from an event
-  * @param event Event name
-  * @param handler Optional specific handler to remove
-  */
-  off: <K extends keyof TEvents>(event: K, handler?: TEvents[K]) => void;
-  /**
-  * Subscribe to an event
-  * @param event Event name
-  * @param handler Event handler
-  * @returns Unsubscribe function
-  */
-  on: <K extends keyof TEvents>(event: K, handler: TEvents[K]) => () => void;
-  /**
-  * Subscribe to an event once
-  * @param event Event name
-  * @param handler Event handler
-  */
-  once: <K extends keyof TEvents>(event: K, handler: TEvents[K]) => void;
-  /**
-  * Send a message/event
-  * @param event Event name
-  * @param data Event data
-  */
-  send: <K extends keyof TEvents>(event: K, ...args: Parameters<TEvents[K]>) => void;
-}
-/**
-* Channel factory function
-*/
-type ChannelFactory<TEvents extends Record<string, (...args: any[]) => void>> = () => MessageChannel<TEvents>;
-/**
-* Factory result providing a method to instantiate named message channels.
-*/
-interface MessageChannelContext<TEvents extends Record<string, (...args: any[]) => void>> {
-  /**
-  * Creates and returns a new channel instance.
-  */
-  createChannel: () => MessageChannel<TEvents>;
-}
-/**
 * Creates a dev toolbar hook instance.
 * @param onRegisterApp Callback when app is registered.
 * @param onTimelineEvent Callback when timeline event is added.
@@ -125,6 +82,49 @@ declare class TimelineStore {
 */
 declare const getTimelineStore: () => TimelineStore;
 /**
+* Message channel interface for bidirectional communication
+*/
+interface MessageChannel<TEvents extends Record<string, (...args: any[]) => void>> {
+  /**
+  * Unsubscribe from an event
+  * @param event Event name
+  * @param handler Optional specific handler to remove
+  */
+  off: <K extends keyof TEvents>(event: K, handler?: TEvents[K]) => void;
+  /**
+  * Subscribe to an event
+  * @param event Event name
+  * @param handler Event handler
+  * @returns Unsubscribe function
+  */
+  on: <K extends keyof TEvents>(event: K, handler: TEvents[K]) => () => void;
+  /**
+  * Subscribe to an event once
+  * @param event Event name
+  * @param handler Event handler
+  */
+  once: <K extends keyof TEvents>(event: K, handler: TEvents[K]) => void;
+  /**
+  * Send a message/event
+  * @param event Event name
+  * @param data Event data
+  */
+  send: <K extends keyof TEvents>(event: K, ...args: Parameters<TEvents[K]>) => void;
+}
+/**
+* Channel factory function
+*/
+type ChannelFactory<TEvents extends Record<string, (...args: any[]) => void>> = () => MessageChannel<TEvents>;
+/**
+* Factory result providing a method to instantiate named message channels.
+*/
+interface MessageChannelContext<TEvents extends Record<string, (...args: any[]) => void>> {
+  /**
+  * Creates and returns a new channel instance.
+  */
+  createChannel: () => MessageChannel<TEvents>;
+}
+/**
 * Loads settings from localStorage, merging with defaults.
 * @returns Toolbar settings.
 */

package/dist/toolbar/index.d.ts

@@ -1,5 +1,5 @@
 import { D as DevToolbarApp, a as DevToolbarAppState } from "../packem_shared/app.d-SmKEDxsI.js";
-import "../packem_shared/global-api.d-BLfn-OUA.js";
+import "../packem_shared/global-api.d-DG2WYakl.js";
 import 'vite';
 import 'preact';
 /**

package/dist/vite-plugin.d.ts

@@ -1,6 +1,6 @@
 import { Plugin } from 'vite';
 import { D as DevToolbarApp, S as ServerFunctions } from "./packem_shared/app.d-SmKEDxsI.js";
-import "./packem_shared/global-api.d-BLfn-OUA.js";
+import "./packem_shared/global-api.d-DG2WYakl.js";
 import '@babel/generator';
 import 'preact';
 interface InjectSourceIgnore {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/dev-toolbar",
-  "version": "1.0.0-alpha.14",
+  "version": "1.0.0-alpha.15",
   "description": "Devtools is a set of tools for building advanced devtools for your application",
   "keywords": [
     "dev-toolbar",
@@ -114,7 +114,7 @@
   ],
   "dependencies": {
     "@babel/generator": "^7.29.1",
-    "@babel/parser": "7.29.2",
+    "@babel/parser": "7.29.3",
     "@babel/traverse": "^7.29.0",
     "@floating-ui/dom": "^1.7.6",
     "launch-editor": "2.13.2",
@@ -124,7 +124,7 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "axe-core": "4.11.4",
     "vite": "^6 || ^7 || ^8",
-    "zod": "^3.0.0"
+    "zod": "^3.25.0 || ^4.0.0"
   },
   "peerDependenciesMeta": {
     "@modelcontextprotocol/sdk": {

package/dist/packem_shared/{global-api.d-BLfn-OUA.d.ts → global-api.d-DG2WYakl.d.ts}

@@ -1,162 +1,6 @@
 import { D as DevToolbarApp, T as ToolbarSettings } from "./app.d-SmKEDxsI.js";
 import { ViteDevServer } from 'vite';
 /**
-* Annotation intent — describes what the user wants to communicate.
-*/
-type AnnotationIntent = "approve" | "change" | "fix" | "question";
-/**
-* Annotation severity — how urgent or important the annotation is.
-*/
-type AnnotationSeverity = "blocking" | "important" | "suggestion";
-/**
-* Annotation status — lifecycle state.
-*/
-type AnnotationStatus = "acknowledged" | "dismissed" | "pending" | "resolved";
-/**
-* A single message in a conversation thread attached to an annotation.
-*/
-interface ThreadMessage {
-  /** Message text */
-  content: string;
-  /** Unique message identifier */
-  id?: string;
-  /** Who wrote it — e.g. "human", "agent", or a specific agent name */
-  role: string;
-  /** ISO 8601 timestamp */
-  timestamp: string;
-}
-/**
-* Bounding box of the annotated element relative to the viewport.
-*/
-interface BoundingBox {
-  height: number;
-  width: number;
-  x: number;
-  y: number;
-}
-/**
-* Detected framework component information.
-*/
-interface FrameworkContext {
-  /** Component name */
-  componentName?: string;
-  /** Full component stack (e.g. ["App", "Layout", "Header", "Button"]) */
-  componentStack?: string[];
-  /** Additional framework-specific data (e.g. props) */
-  data?: Record<string, unknown>;
-  /** Framework identifier (react, vue, svelte, etc.) */
-  framework: string;
-  /** Source file path */
-  sourceFile?: string;
-  /** Source line number */
-  sourceLine?: number;
-}
-/**
-* Captured accessibility attributes for an element.
-*/
-interface AccessibilityInfo {
-  /** aria-describedby content */
-  ariaDescribedBy?: string;
-  /** aria-label value */
-  ariaLabel?: string;
-  /** Whether the element is focusable */
-  focusable: boolean;
-  /** ARIA role (explicit or implicit) */
-  role?: string;
-  /** tabindex value */
-  tabindex?: number;
-}
-/**
-* A visual annotation placed on a page element during development.
-* Stored in `.devtoolbar/annotations.json`.
-*/
-interface Annotation {
-  /** Captured accessibility attributes */
-  accessibility?: AccessibilityInfo;
-  /** Element bounding box at annotation time */
-  boundingBox?: BoundingBox;
-  /** User feedback / description */
-  comment: string;
-  /** Key computed CSS properties for forensic context */
-  computedStyles?: string;
-  /** ISO 8601 creation timestamp */
-  createdAt: string;
-  /** CSS classes on the annotated element (module hashes cleaned) */
-  cssClasses?: string;
-  /** Bounding boxes for multi-select annotations */
-  elementBoundingBoxes?: BoundingBox[];
-  /** Human-readable element label (e.g. 'button "Submit"') */
-  elementLabel?: string;
-  /** CSS selector path to the element */
-  elementPath?: string;
-  /** HTML tag name of the annotated element */
-  elementTag: string;
-  /** Detected framework component context */
-  frameworkContext?: FrameworkContext;
-  /** Full DOM ancestry path (e.g. "body > main > article > p") */
-  fullPath?: string;
-  /** Unique identifier (crypto.randomUUID) */
-  id: string;
-  /** What the user wants — fix, change, question, or approve */
-  intent: AnnotationIntent;
-  /** Whether the element has fixed/sticky positioning */
-  isFixed?: boolean;
-  /** Whether this is a multi-select (drag) annotation */
-  isMultiSelect?: boolean;
-  /** Sibling elements for spatial context */
-  nearbyElements?: string;
-  /** Text near the annotated element for additional context */
-  nearbyText?: string;
-  /** ISO 8601 resolution timestamp */
-  resolvedAt?: string;
-  /** Who resolved it — "human" or "agent" (or a specific agent name) */
-  resolvedBy?: string;
-  /** Path to screenshot file relative to .devtoolbar/ (e.g. "screenshots/&lt;id>.png") */
-  screenshot?: string;
-  /** Text the user had selected when annotating */
-  selectedText?: string;
-  /** Severity level */
-  severity: AnnotationSeverity;
-  /** Source file location from data-vdt-source (file:line:col) */
-  source?: string;
-  /** Lifecycle status */
-  status: AnnotationStatus;
-  /** Conversation thread (human ↔ AI agent) */
-  thread?: ThreadMessage[];
-  /** ISO 8601 last-updated timestamp */
-  updatedAt: string;
-  /** Page URL where the annotation was created */
-  url: string;
-  /** Click X as percentage of viewport width (0-100) — survives resize */
-  x: number;
-  /**
-  * Click Y as absolute page position (pixels from document top) — survives scroll.
-  *  For fixed/sticky elements, Y is viewport-relative instead.
-  */
-  y: number;
-}
-/**
-* Data required to create a new annotation (server-generated fields omitted).
-*/
-type CreateAnnotationData = Omit<Annotation, "createdAt" | "id" | "resolvedAt" | "resolvedBy" | "status" | "thread" | "updatedAt">;
-/**
-* Fields that can be updated on an existing annotation.
-*/
-interface UpdateAnnotationData {
-  /** Updated comment text */
-  comment?: string;
-  /** Updated intent */
-  intent?: AnnotationIntent;
-  /** Who resolved the annotation */
-  resolvedBy?: string;
-  /** Updated severity */
-  severity?: AnnotationSeverity;
-  /** New status */
-  status?: AnnotationStatus;
-  /** Append a thread message */
-  threadMessage?: ThreadMessage;
-}
-/**
 * Severity levels for timeline events.
 */
 type TimelineEventLevel = "info" | "warning" | "error";
@@ -328,6 +172,162 @@ interface TailwindConfigResult {
   version: "v3" | "v4" | "unknown";
 }
 /**
+* Annotation intent — describes what the user wants to communicate.
+*/
+type AnnotationIntent = "approve" | "change" | "fix" | "question";
+/**
+* Annotation severity — how urgent or important the annotation is.
+*/
+type AnnotationSeverity = "blocking" | "important" | "suggestion";
+/**
+* Annotation status — lifecycle state.
+*/
+type AnnotationStatus = "acknowledged" | "dismissed" | "pending" | "resolved";
+/**
+* A single message in a conversation thread attached to an annotation.
+*/
+interface ThreadMessage {
+  /** Message text */
+  content: string;
+  /** Unique message identifier */
+  id?: string;
+  /** Who wrote it — e.g. "human", "agent", or a specific agent name */
+  role: string;
+  /** ISO 8601 timestamp */
+  timestamp: string;
+}
+/**
+* Bounding box of the annotated element relative to the viewport.
+*/
+interface BoundingBox {
+  height: number;
+  width: number;
+  x: number;
+  y: number;
+}
+/**
+* Detected framework component information.
+*/
+interface FrameworkContext {
+  /** Component name */
+  componentName?: string;
+  /** Full component stack (e.g. ["App", "Layout", "Header", "Button"]) */
+  componentStack?: string[];
+  /** Additional framework-specific data (e.g. props) */
+  data?: Record<string, unknown>;
+  /** Framework identifier (react, vue, svelte, etc.) */
+  framework: string;
+  /** Source file path */
+  sourceFile?: string;
+  /** Source line number */
+  sourceLine?: number;
+}
+/**
+* Captured accessibility attributes for an element.
+*/
+interface AccessibilityInfo {
+  /** aria-describedby content */
+  ariaDescribedBy?: string;
+  /** aria-label value */
+  ariaLabel?: string;
+  /** Whether the element is focusable */
+  focusable: boolean;
+  /** ARIA role (explicit or implicit) */
+  role?: string;
+  /** tabindex value */
+  tabindex?: number;
+}
+/**
+* A visual annotation placed on a page element during development.
+* Stored in `.devtoolbar/annotations.json`.
+*/
+interface Annotation {
+  /** Captured accessibility attributes */
+  accessibility?: AccessibilityInfo;
+  /** Element bounding box at annotation time */
+  boundingBox?: BoundingBox;
+  /** User feedback / description */
+  comment: string;
+  /** Key computed CSS properties for forensic context */
+  computedStyles?: string;
+  /** ISO 8601 creation timestamp */
+  createdAt: string;
+  /** CSS classes on the annotated element (module hashes cleaned) */
+  cssClasses?: string;
+  /** Bounding boxes for multi-select annotations */
+  elementBoundingBoxes?: BoundingBox[];
+  /** Human-readable element label (e.g. 'button "Submit"') */
+  elementLabel?: string;
+  /** CSS selector path to the element */
+  elementPath?: string;
+  /** HTML tag name of the annotated element */
+  elementTag: string;
+  /** Detected framework component context */
+  frameworkContext?: FrameworkContext;
+  /** Full DOM ancestry path (e.g. "body > main > article > p") */
+  fullPath?: string;
+  /** Unique identifier (crypto.randomUUID) */
+  id: string;
+  /** What the user wants — fix, change, question, or approve */
+  intent: AnnotationIntent;
+  /** Whether the element has fixed/sticky positioning */
+  isFixed?: boolean;
+  /** Whether this is a multi-select (drag) annotation */
+  isMultiSelect?: boolean;
+  /** Sibling elements for spatial context */
+  nearbyElements?: string;
+  /** Text near the annotated element for additional context */
+  nearbyText?: string;
+  /** ISO 8601 resolution timestamp */
+  resolvedAt?: string;
+  /** Who resolved it — "human" or "agent" (or a specific agent name) */
+  resolvedBy?: string;
+  /** Path to screenshot file relative to .devtoolbar/ (e.g. "screenshots/&lt;id>.png") */
+  screenshot?: string;
+  /** Text the user had selected when annotating */
+  selectedText?: string;
+  /** Severity level */
+  severity: AnnotationSeverity;
+  /** Source file location from data-vdt-source (file:line:col) */
+  source?: string;
+  /** Lifecycle status */
+  status: AnnotationStatus;
+  /** Conversation thread (human ↔ AI agent) */
+  thread?: ThreadMessage[];
+  /** ISO 8601 last-updated timestamp */
+  updatedAt: string;
+  /** Page URL where the annotation was created */
+  url: string;
+  /** Click X as percentage of viewport width (0-100) — survives resize */
+  x: number;
+  /**
+  * Click Y as absolute page position (pixels from document top) — survives scroll.
+  *  For fixed/sticky elements, Y is viewport-relative instead.
+  */
+  y: number;
+}
+/**
+* Data required to create a new annotation (server-generated fields omitted).
+*/
+type CreateAnnotationData = Omit<Annotation, "createdAt" | "id" | "resolvedAt" | "resolvedBy" | "status" | "thread" | "updatedAt">;
+/**
+* Fields that can be updated on an existing annotation.
+*/
+interface UpdateAnnotationData {
+  /** Updated comment text */
+  comment?: string;
+  /** Updated intent */
+  intent?: AnnotationIntent;
+  /** Who resolved the annotation */
+  resolvedBy?: string;
+  /** Updated severity */
+  severity?: AnnotationSeverity;
+  /** New status */
+  status?: AnnotationStatus;
+  /** Append a thread message */
+  threadMessage?: ThreadMessage;
+}
+/**
 * Server-side RPC functions
 * These can be called from the client
 */