@visulima/dev-toolbar 1.0.0-alpha.9 → 1.0.0

package/dist/vite-plugin.d.ts

@@ -1,149 +1,186 @@
-import type { Plugin } from "vite";
-import type { DevToolbarApp, ServerFunctions } from "./types/index.d.ts";
-import type { InjectSourceIgnore } from "./vite/inject-source.d.ts";
+import { Plugin } from 'vite';
+import { R as ReadFileOptions } from "./packem_shared/server.d-ZkcY0pge.js";
+import { D as DevToolbarApp, S as ServerFunctions } from "./packem_shared/app.d-SmKEDxsI.js";
+import "./packem_shared/global-api.d-DeaCvII9.js";
+import '@babel/generator';
+import 'preact';
+interface InjectSourceIgnore {
+  /** Component names or patterns to skip. */
+  components?: (RegExp | string)[];
+  /** File paths or patterns to skip. */
+  files?: (RegExp | string)[];
+}
 /**
- * Dev toolbar plugin options
- */
-export interface DevToolbarOptions {
-    /**
-     * append an import to the module id ending with `appendTo` instead of adding a script into body
-     * useful for projects that do not use html file as an entry
-     *
-     * WARNING: only set this if you know exactly what it does.
-     * @default Empty string (disabled).
-     */
-    appendTo?: string | RegExp;
-    /**
-     * Built-in apps to enable. All apps are disabled by default — only
-     * `viteConfig`, `settings`, and the "more" drawer are shown out of the box.
-     * Explicitly set an app to `true` to enable it.
-     * @example { inspector: true, seo: true }
-     */
-    apps?: {
-        [key: string]: boolean | undefined;
-        a11y?: boolean;
-        annotations?: boolean;
-        assets?: boolean;
-        inspector?: boolean;
-        moduleGraph?: boolean;
-        performance?: boolean;
-        seo?: boolean;
-        settings?: boolean;
-        tailwind?: boolean;
-        timeline?: boolean;
-        viteConfig?: boolean;
-    };
-    /**
-     * Whether clicking outside the DevTools panel closes it.
-     * @default true
-     */
-    closeOnOutsideClick?: boolean;
-    /**
-     * Custom apps to register
-     */
-    customApps?: DevToolbarApp[];
-    /**
-     * Whether toolbar is visible by default
-     */
-    defaultVisible?: boolean;
-    /**
-     * The editor to open when clicking "Open in editor" in the inspector.
-     * Accepts any value supported by `launch-editor` — an editor name/alias
-     * (e.g. `"code"`, `"webstorm"`, `"vim"`, `"atom"`) or the full path to
-     * the editor executable.
-     *
-     * If omitted, `launch-editor` auto-detects the editor from the `EDITOR`
-     * / `VISUAL` environment variables or from the currently running IDE
-     * process detected on the OS process list.
-     * @example "webstorm"
-     * @example "code"
-     */
-    editor?: string;
-    /**
-     * Initial panel height as a percentage of the viewport height (20–95).
-     * @default 60
-     */
-    height?: number;
-    /**
-     * Inject `data-vdt-source="<file>:<line>:<col>"` attributes into every JSX
-     * opening element during development. This lets the inspector jump directly
-     * to the source file when an element is clicked.
-     *
-     * Only active when `mode === 'development'`. Set `enabled: false` to opt out.
-     * Use `ignore.files` / `ignore.components` to exclude specific paths or
-     * component names (strings are treated as glob patterns).
-     * @default { enabled: true }
-     */
-    injectSource?: {
-        enabled?: boolean;
-        ignore?: InjectSourceIgnore;
-    };
-    /**
-     * Keyboard shortcut bindings.
-     * These are project-level defaults; users can still override them via the
-     * Settings app (stored in localStorage).
-     */
-    keybindings?: {
-        /** Close active app / panel. \@default "Escape" */
-        close?: string;
-        /** Toggle the DevTools panel open/closed. \@default "Alt+Shift+D" */
-        toggle?: string;
-    };
-    /**
-     * Auto-hide the toolbar pill after this many milliseconds of inactivity.
-     * Set to -1 to never auto-hide.
-     * @default 5000
-     */
-    minimizePanelInactive?: number;
-    /**
-     * Toolbar placement (coarse shorthand — sets the edge and rough horizontal
-     * alignment of the toolbar pill).
-     * @default "bottom-center"
-     */
-    placement?: "bottom-left" | "bottom-center" | "bottom-right";
-    /**
-     * Which edge of the viewport the toolbar pill is anchored to.
-     * Takes precedence over the edge implied by `placement`.
-     * @default "bottom"
-     */
-    position?: "bottom" | "left" | "right" | "top";
-    /**
-     * Reduce motion for accessibility (disables all CSS animations).
-     * @default false
-     */
-    reduceMotion?: boolean;
-    /**
-     * Strip all \@visulima/dev-toolbar imports and virtual modules when building
-     * for production (i.e. when `command !== 'serve'` or `mode === 'production'`).
-     * This guarantees the toolbar never ends up in a production bundle even if the
-     * user accidentally imports our package in application code.
-     * @default true
-     */
-    removeDevtoolsOnBuild?: boolean;
-    /**
-     * Only activate the toolbar when the URL contains a specific query parameter.
-     * Useful for staging/production environments where you want opt-in debugging.
-     * @example requireUrlFlag: true, urlFlagName: 'debug' → toolbar only shows when URL has ?debug=true
-     * @default false
-     */
-    requireUrlFlag?: boolean;
-    /**
-     * Custom server RPC functions
-     */
-    serverFunctions?: Partial<ServerFunctions>;
-    /**
-     * The URL query parameter name used when requireUrlFlag is true.
-     * @default 'devtools'
-     */
-    urlFlagName?: string;
-    /**
-     * Initial panel width as a percentage of the viewport width (20–95).
-     * Applies when position is "left" or "right".
-     * @default 80
-     */
-    width?: number;
+* Dev toolbar plugin options
+*/
+interface DevToolbarOptions {
+  /**
+  * append an import to the module id ending with `appendTo` instead of adding a script into body
+  * useful for projects that do not use html file as an entry
+  *
+  * WARNING: only set this if you know exactly what it does.
+  * @default Empty string (disabled).
+  */
+  appendTo?: string | RegExp;
+  /**
+  * Built-in apps to enable. All apps are disabled by default — only
+  * `viteConfig`, `settings`, and the "more" drawer are shown out of the box.
+  * Explicitly set an app to `true` to enable it.
+  * @example { inspector: true, seo: true }
+  */
+  apps?: {
+    [key: string]: boolean | undefined;
+    a11y?: boolean;
+    annotations?: boolean;
+    assets?: boolean;
+    inspector?: boolean;
+    moduleGraph?: boolean;
+    performance?: boolean;
+    seo?: boolean;
+    settings?: boolean;
+    tailwind?: boolean;
+    timeline?: boolean;
+    viteConfig?: boolean;
+  };
+  /**
+  * Whether clicking outside the DevTools panel closes it.
+  * @default true
+  */
+  closeOnOutsideClick?: boolean;
+  /**
+  * Custom apps to register
+  */
+  customApps?: DevToolbarApp[];
+  /**
+  * Whether toolbar is visible by default
+  */
+  defaultVisible?: boolean;
+  /**
+  * The editor to open when clicking "Open in editor" in the inspector.
+  * Accepts any value supported by `launch-editor` — an editor name/alias
+  * (e.g. `"code"`, `"webstorm"`, `"vim"`, `"atom"`) or the full path to
+  * the editor executable.
+  *
+  * If omitted, `launch-editor` auto-detects the editor from the `EDITOR`
+  * / `VISUAL` environment variables or from the currently running IDE
+  * process detected on the OS process list.
+  * @example "webstorm"
+  * @example "code"
+  */
+  editor?: string;
+  /**
+  * Master switch for the whole plugin. When `false`, `devToolbar()` returns an
+  * empty plugin array, so no virtual modules, RPC server, or client overlay are
+  * registered — the equivalent of removing the plugin from `vite.config.ts`
+  * without editing the config.
+  *
+  * Handy for CI/preview environments:
+  * `devToolbar({ enabled: !process.env.CI })`.
+  * @default true
+  */
+  enabled?: boolean;
+  /**
+  * Initial panel height as a percentage of the viewport height (20–95).
+  * @default 60
+  */
+  height?: number;
+  /**
+  * Inject `data-vdt-source="&lt;file>:&lt;line>:&lt;col>"` attributes into every JSX
+  * opening element during development. This lets the inspector jump directly
+  * to the source file when an element is clicked.
+  *
+  * Only active when `mode === 'development'`. Set `enabled: false` to opt out.
+  * Use `ignore.files` / `ignore.components` to exclude specific paths or
+  * component names (strings are treated as glob patterns).
+  * @default { enabled: true }
+  */
+  injectSource?: {
+    enabled?: boolean;
+    ignore?: InjectSourceIgnore;
+  };
+  /**
+  * Keyboard shortcut bindings.
+  * These are project-level defaults; users can still override them via the
+  * Settings app (stored in localStorage).
+  */
+  keybindings?: {
+    /** Close active app / panel. \@default "Escape" */
+    close?: string;
+    /** Toggle the DevTools panel open/closed. \@default "Alt+Shift+D" */
+    toggle?: string;
+  };
+  /**
+  * Auto-hide the toolbar pill after this many milliseconds of inactivity.
+  * Set to -1 to never auto-hide.
+  * @default 5000
+  */
+  minimizePanelInactive?: number;
+  /**
+  * Toolbar placement (coarse shorthand — sets the edge and rough horizontal
+  * alignment of the toolbar pill).
+  * @default "bottom-center"
+  */
+  placement?: "bottom-left" | "bottom-center" | "bottom-right";
+  /**
+  * Which edge of the viewport the toolbar pill is anchored to.
+  * Takes precedence over the edge implied by `placement`.
+  * @default "bottom"
+  */
+  position?: "bottom" | "left" | "right" | "top";
+  /**
+  * Policy for the built-in `readFile` RPC endpoint, which lets toolbar apps read
+  * text files under the project root.
+  *
+  * Set to `false` to remove the endpoint entirely — recommended when the dev
+  * server is exposed on the network (`vite --host`), since any device on the LAN
+  * can then call RPC methods. Pass an object to override the allowed extensions.
+  *
+  * By default the endpoint is restricted to a curated allowlist of source/markup/
+  * text extensions, so `.env`, lockfiles, and key material are never served.
+  * @default { extensions: curated source/text list }
+  */
+  readFile?: ReadFileOptions | false;
+  /**
+  * Reduce motion for accessibility (disables all CSS animations).
+  * @default false
+  */
+  reduceMotion?: boolean;
+  /**
+  * Strip all \@visulima/dev-toolbar imports and virtual modules when building
+  * for production (i.e. when `command !== 'serve'` or `mode === 'production'`).
+  * This guarantees the toolbar never ends up in a production bundle even if the
+  * user accidentally imports our package in application code.
+  * @default true
+  */
+  removeDevtoolsOnBuild?: boolean;
+  /**
+  * Only activate the toolbar when the URL contains a specific query parameter.
+  * Useful for staging/production environments where you want opt-in debugging.
+  * @example requireUrlFlag: true, urlFlagName: 'debug' → toolbar only shows when URL has ?debug=true
+  * @default false
+  */
+  requireUrlFlag?: boolean;
+  /**
+  * Custom server RPC functions
+  */
+  serverFunctions?: Partial<ServerFunctions>;
+  /**
+  * The URL query parameter name used when requireUrlFlag is true.
+  * @default 'devtools'
+  */
+  urlFlagName?: string;
+  /**
+  * Initial panel width as a percentage of the viewport width (20–95).
+  * Applies when position is "left" or "right".
+  * @default 80
+  */
+  width?: number;
 }
 /**
- * Returns the Vite plugin array for the dev toolbar.
- */
-export declare const devToolbar: (options?: DevToolbarOptions) => Plugin[];
+* Returns the Vite plugin array for the dev toolbar.
+*
+* Returns an empty array when `options.enabled === false`, so the plugin can be
+* gated for CI/preview builds without removing it from `vite.config.ts`.
+*/
+declare const devToolbar: (options?: DevToolbarOptions) => Plugin[];
+export { DevToolbarOptions, devToolbar };

package/dist/vite-plugin.js

@@ -1,5 +1,5 @@
-var O=Object.defineProperty;var g=(e,r)=>O(e,"name",{value:r,configurable:!0});import{createRequire as x}from"node:module";import{normalizePath as I}from"vite";import{createServerRPCContext as k}from"./packem_shared/createServerRPCContext-CJ6F87o_.js";const F=x(import.meta.url),d=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,b=g(e=>{if(typeof d<"u"&&d.versions&&d.versions.node){const[r,f]=d.versions.node.split(".").map(Number);if(r>22||r===22&&f>=3||r===20&&f>=16)return d.getBuiltinModule(e)}return F(e)},"__cjs_getBuiltinModule"),P=b("node:fs"),T=b("node:path"),{fileURLToPath:S}=b("node:url");var R=Object.defineProperty,m=g((e,r)=>R(e,"name",{value:r,configurable:!0}),"u");const q=m(()=>I(T.dirname(S(import.meta.url))),"getDevToolbarPath"),D=/\?.+$/,M=/\/dist\/|\/build\//,N=/\.[jt]sx$/,W=m(e=>e.replace(D,""),"removeUrlQuery"),w="?__visulima-dev-toolbar-resource",h="virtual:visulima-dev-toolbar-options",_=`\0${h}`,u="virtual:visulima-dev-toolbar-path:",j="\0__visulima-dev-toolbar-empty",E=m((e={})=>{const r=q(),f=e.removeDevtoolsOnBuild??!0,$=e.injectSource?.enabled??!0;let v;return[{apply:"serve",config(){return{server:{watch:{ignored:["**/.devtoolbar/**"]}}}},configResolved(t){if(v=t,!e.appendTo){const o=new Set(t.plugins.map(n=>n.name));(o.has("tanstack-start-core:config")||o.has("tanstack-react-start:config"))&&(e.appendTo=/router\.tsx$/)}const a=/dev-toolbar[\\/]dist[\\/]|__visulima-dev-toolbar-resource/;for(const o of t.plugins){if(!o.name.includes("babel"))continue;const n=o.transform;if(!n)continue;const i=typeof n=="function"?n:typeof n=="object"&&"handler"in n?n.handler:void 0;if(typeof i!="function")continue;const s=m(function(l,c,...p){if(!a.test(c))return i.call(this,l,c,...p)},"wrapper");typeof n=="function"?o.transform=s:n.handler=s}},configureServer(t){k(t,e.serverFunctions,{editor:e.editor}),t.ws.on("connection",()=>{t.ws.send({event:"dev-toolbar:init",type:"custom"})}),t.middlewares.use("/__devtoolbar/events",async(a,o)=>{o.writeHead(200,{"Cache-Control":"no-cache",Connection:"keep-alive","Content-Type":"text/event-stream","X-Accel-Buffering":"no"});const n=m((c,p)=>{o.write(`event: ${c}
-data: ${JSON.stringify(p)}
+import{createRequire as O}from"node:module";import{normalizePath as R}from"vite";import{createServerRPCContext as N}from"./packem_shared/createServerRPCContext-2MNcj-v3.js";const M=O(import.meta.url),u=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,y=e=>{if(typeof u<"u"&&u.versions&&u.versions.node){const[p,f]=u.versions.node.split(".").map(Number);if(p>22||p===22&&f>=3||p===20&&f>=16)return u.getBuiltinModule(e)}return M(e)},S=y("node:fs"),x=y("node:path"),{fileURLToPath:I}=y("node:url"),P=()=>R(x.dirname(I(import.meta.url))),q=/\?.+$/,D=/\/dist\/|\/build\//,W=/\.[jt]sx$/,B=e=>e.replace(q,""),_="?__visulima-dev-toolbar-resource",b="virtual:visulima-dev-toolbar-options",j=`\0${b}`,m="virtual:visulima-dev-toolbar-path:",$="\0__visulima-dev-toolbar-empty",T=(e,p)=>typeof e!="number"||!Number.isFinite(e)?p:Math.min(95,Math.max(20,e)),U=(e={})=>{if(e.enabled===!1)return[];const p=P(),f=e.removeDevtoolsOnBuild??!0,C=e.injectSource?.enabled??!0;let v;const F={apply:"serve",config(){return{server:{watch:{ignored:["**/.devtoolbar/**"]}}}},configResolved(t){if(v=t,!e.appendTo){const o=new Set(t.plugins.map(i=>i.name));(o.has("tanstack-start-core:config")||o.has("tanstack-react-start:config"))&&(e.appendTo=/router\.tsx$/)}const n=/dev-toolbar[\\/]dist[\\/]|__visulima-dev-toolbar-resource/;for(const o of t.plugins){if(!o.name.includes("babel"))continue;const i=o.transform;if(!i)continue;const a=typeof i=="function"?i:typeof i=="object"&&"handler"in i?i.handler:void 0;if(typeof a!="function")continue;const s=function(c,r,...l){if(!n.test(r))return a.call(this,c,r,...l)};typeof i=="function"?o.transform=s:i.handler=s}},configureServer(t){N(t,e.serverFunctions,{editor:e.editor,readFile:e.readFile}),t.ws.on("connection",()=>{t.ws.send({event:"dev-toolbar:init",type:"custom"})}),t.middlewares.use("/__devtoolbar/events",async(n,o)=>{o.writeHead(200,{"Cache-Control":"no-cache",Connection:"keep-alive","Content-Type":"text/event-stream","X-Accel-Buffering":"no"});const i=(r,l)=>{o.write(`event: ${r}
+data: ${JSON.stringify(l)}
 
-`)},"sendEvent");n("connected",{timestamp:Date.now()});const{watch:i}=await import("node:fs"),s=T.join(t.config.root,".devtoolbar","annotations.json");let l;try{l=i(s,{persistent:!1},c=>{c==="change"&&n("annotations.changed",{timestamp:Date.now()})}),l.on("error",()=>{})}catch{const{stat:c}=await import("node:fs/promises");let p=0;const C=setInterval(async()=>{try{const y=(await c(s)).mtimeMs;y!==p&&(p=y,n("annotations.changed",{timestamp:Date.now()}))}catch{}},2e3);a.on("close",()=>{clearInterval(C)});return}a.on("close",()=>{l?.close()})})},enforce:"pre",async load(t){if(t===_){const a=(e.customApps??[]).filter(o=>!o.component&&!o.init&&o.view?.type==="iframe").map(o=>({defaultOpen:o.defaultOpen,icon:o.icon,id:o.id,name:o.name,view:o.view}));return`export default ${JSON.stringify({apps:{a11y:e.apps?.a11y??!1,annotations:e.apps?.annotations??e.apps?.inspector??!1,assets:e.apps?.assets??!1,inspector:e.apps?.inspector??!1,moduleGraph:e.apps?.moduleGraph??!1,performance:e.apps?.performance??!1,seo:e.apps?.seo??!1,settings:e.apps?.settings??!0,tailwind:e.apps?.tailwind??!1,timeline:e.apps?.timeline??!1,viteConfig:e.apps?.viteConfig??!0},base:v.base,closeOnOutsideClick:e.closeOnOutsideClick??!0,customApps:a,defaultVisible:e.defaultVisible??!0,editor:e.editor??"",height:e.height??60,keybindings:e.keybindings??{},minimizePanelInactive:e.minimizePanelInactive??5e3,placement:e.placement??"bottom-center",position:e.position??"bottom",reduceMotion:e.reduceMotion??!1,requireUrlFlag:e.requireUrlFlag??!1,urlFlagName:e.urlFlagName??"devtools",width:e.width??80})};`}if(t.endsWith(w)){const a=W(t);return this.addWatchFile(a),await P.promises.readFile(a,"utf8")}},name:"@visulima/dev-toolbar",resolveId(t){if(t===h)return _;if(t.startsWith(u))return`${t.replace(u,`${r}/`)}${w}`},transform(t,a,o){if(o?.ssr)return;const{appendTo:n}=e,i=a.split("?",2)[0];if(n&&i&&(typeof n=="string"&&i.endsWith(n)||n instanceof RegExp&&n.test(i)))return`import '${u}client/overlay.js';
-${t}`},transformIndexHtml(){return e.appendTo?void 0:{html:"",tags:[{attrs:{src:`${v.base||"/"}@id/${u}client/overlay.js`,type:"module"},injectTo:"head-prepend",tag:"script"}]}}},{enforce:"pre",name:"@visulima/dev-toolbar:inject-source",async transform(t,a){if(!$||v.mode!=="development"||a.includes("node_modules")||a.includes("?raw")||M.test(a)||!N.test(a.split("?")[0]??""))return;const{readFile:o}=await import("node:fs/promises");let n;try{const l=await o(a.split("?")[0]??a,"utf8");l!==t&&(n=l)}catch{}const{addSourceToJsx:i}=await import("./packem_chunks/inject-source.js"),s=i(t,a,e.injectSource?.ignore,n);if(s)return{code:s.code??t,map:s.map??void 0}}},{apply(t,{command:a,mode:o}){return f&&(a!=="serve"||o==="production")},load(t){if(t===j)return"export default {};"},name:"@visulima/dev-toolbar:remove-on-build",resolveId(t){if(t===h||t.startsWith(u))return j}}]},"devToolbar");export{E as devToolbar};
+`)};i("connected",{timestamp:Date.now()});const{watch:a}=await import("node:fs"),s=x.join(t.config.root,".devtoolbar","annotations.json");let c;try{c=a(s,{persistent:!1},r=>{r==="change"&&i("annotations.changed",{timestamp:Date.now()})}),c.on("error",()=>{})}catch{const{stat:r}=await import("node:fs/promises");let l=0;const h=setInterval(async()=>{try{const d=(await r(s)).mtimeMs;d!==l&&(l=d,i("annotations.changed",{timestamp:Date.now()}))}catch{}},2e3);n.on("close",()=>{clearInterval(h)});return}n.on("close",()=>{c?.close()})})},enforce:"pre",async load(t){if(t===j){const n=(e.customApps??[]).filter(o=>!o.component&&!o.init&&o.view?.type==="iframe").map(o=>({defaultOpen:o.defaultOpen,icon:o.icon,id:o.id,name:o.name,view:o.view}));return`export default ${JSON.stringify({apps:{a11y:e.apps?.a11y??!1,annotations:e.apps?.annotations??e.apps?.inspector??!1,assets:e.apps?.assets??!1,inspector:e.apps?.inspector??!1,moduleGraph:e.apps?.moduleGraph??!1,performance:e.apps?.performance??!1,seo:e.apps?.seo??!1,settings:e.apps?.settings??!0,tailwind:e.apps?.tailwind??!1,timeline:e.apps?.timeline??!1,viteConfig:e.apps?.viteConfig??!0},base:v.base,closeOnOutsideClick:e.closeOnOutsideClick??!0,customApps:n,defaultVisible:e.defaultVisible??!0,editor:e.editor??"",height:T(e.height,60),keybindings:e.keybindings??{},minimizePanelInactive:e.minimizePanelInactive??5e3,placement:e.placement??"bottom-center",position:e.position??"bottom",reduceMotion:e.reduceMotion??!1,requireUrlFlag:e.requireUrlFlag??!1,urlFlagName:e.urlFlagName??"devtools",width:T(e.width,80)})};`}if(t.endsWith(_)){const n=B(t);return this.addWatchFile(n),await S.promises.readFile(n,"utf8")}},name:"@visulima/dev-toolbar",resolveId(t){if(t===b)return j;if(t.startsWith(m))return`${t.replace(m,`${p}/`)}${_}`},transform(t,n,o){if(o?.ssr)return;const{appendTo:i}=e,a=n.split("?",2)[0];if(i&&a&&(typeof i=="string"&&a.endsWith(i)||i instanceof RegExp&&i.test(a)))return`import '${m}client/overlay.js';
+${t}`},transformIndexHtml(){return e.appendTo?void 0:{html:"",tags:[{attrs:{src:`${v.base||"/"}@id/${m}client/overlay.js`,type:"module"},injectTo:"head-prepend",tag:"script"}]}}},k={apply(t,{command:n,mode:o}){return f&&(n!=="serve"||o==="production")},load(t){if(t===$)return"export default {};"},name:"@visulima/dev-toolbar:remove-on-build",resolveId(t){if(t===b||t.startsWith(m))return $}},w=new Map;return[F,{enforce:"pre",name:"@visulima/dev-toolbar:inject-source",async transform(t,n){if(!C||v.mode!=="development"||n.includes("node_modules")||n.includes("?raw")||D.test(n)||!W.test(n.split("?")[0]??""))return;const o=n.split("?")[0]??n,{readFile:i,stat:a}=await import("node:fs/promises");let s;try{const{mtimeMs:d}=await a(o);s=`${t.length}:${d}`;const g=w.get(n);if(g&&g.key===s)return g.result}catch{}let c;try{const d=await i(o,"utf8");d!==t&&(c=d)}catch{}const{addSourceToJsx:r}=await import("./packem_chunks/inject-source.js"),l=r(t,n,e.injectSource?.ignore,c),h=l?{code:l.code??t,map:l.map??void 0}:void 0;return s!==void 0&&w.set(n,{key:s,result:h}),h}},k]};export{U as devToolbar};

package/package.json

@@ -1,15 +1,13 @@
 {
   "name": "@visulima/dev-toolbar",
-  "version": "1.0.0-alpha.9",
+  "version": "1.0.0",
   "description": "Devtools is a set of tools for building advanced devtools for your application",
   "keywords": [
-    "visulima",
-    "dev-toolbar"
+    "dev-toolbar",
+    "visulima"
   ],
   "homepage": "https://visulima.com/packages/dev-toolbar",
-  "bugs": {
-    "url": "https://github.com/visulima/visulima/issues"
-  },
+  "bugs": "https://github.com/visulima/visulima/issues",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/visulima/visulima.git",
@@ -113,18 +111,18 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@babel/generator": "^7.29.1",
-    "@babel/parser": "7.29.2",
-    "@babel/traverse": "^7.29.0",
+    "@babel/generator": "^8.0.0",
+    "@babel/parser": "^8.0.0",
+    "@babel/traverse": "^8.0.0",
     "@floating-ui/dom": "^1.7.6",
-    "launch-editor": "2.13.2",
-    "preact": "^10.29.1"
+    "launch-editor": "2.14.1",
+    "preact": "^10.29.2"
   },
   "peerDependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "axe-core": "4.11.2",
-    "vite": "^6 || ^7 || ^8",
-    "zod": "^3.0.0"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "axe-core": ">=4.12.1",
+    "vite": "^8.0.11",
+    "zod": "^3.25.0 || ^4.0.0"
   },
   "peerDependenciesMeta": {
     "@modelcontextprotocol/sdk": {
@@ -138,7 +136,7 @@
     }
   },
   "engines": {
-    "node": ">=22.21"
+    "node": "^22.14.0 || >=24.10.0"
   },
   "publishConfig": {
     "access": "public",

package/dist/apps/a11y/a11y-app.d.ts

@@ -1,4 +0,0 @@
-import type { ComponentChildren } from "preact";
-import type { AppComponentProps } from "../../types/app.d.ts";
-declare const A11yApp: (_props: AppComponentProps) => ComponentChildren;
-export default A11yApp;

package/dist/apps/a11y/a11y-store.d.ts

@@ -1,42 +0,0 @@
-type Severity = "critical" | "minor" | "moderate" | "serious";
-type Standard = "best-practice" | "wcag21aa" | "wcag22aa" | "wcag2a";
-interface A11yNode {
-    html: string;
-    selector: string;
-}
-interface A11yIssue {
-    helpUrl: string;
-    id: string;
-    impact: Severity;
-    message: string;
-    nodes: A11yNode[];
-    wcagTags: string[];
-}
-interface A11yStoreState {
-    isScanning: boolean;
-    issues: A11yIssue[];
-    lastScan: string | undefined;
-    scanError: string | undefined;
-    showOverlays: boolean;
-    standard: Standard;
-}
-declare const SEVERITY_ORDER: Severity[];
-type Listener = () => void;
-declare class A11yStore {
-    private listeners;
-    private state;
-    constructor();
-    clearHighlights(): void;
-    getState(): Readonly<A11yStoreState>;
-    highlightIssue(issue: A11yIssue): void;
-    scan(disabledRules?: string[]): Promise<void>;
-    setShowOverlays(show: boolean): void;
-    setStandard(standard: Standard): void;
-    subscribe(listener: Listener): () => void;
-    private notify;
-    private persist;
-    private update;
-}
-declare const a11yStore: A11yStore;
-export type { A11yIssue, A11yNode, A11yStoreState, Severity, Standard };
-export { a11yStore, SEVERITY_ORDER };

package/dist/apps/a11y/a11y-tooltip.d.ts

@@ -1,10 +0,0 @@
-import type { ComponentChildren } from "preact";
-import type { AppTooltipProps } from "../../types/app.d.ts";
-/**
- * Hover tooltip for the Accessibility app button.
- * Shows a summary of scan results and quick action buttons.
- * @param _props Tooltip props (unused; reads from a11yStore directly)
- * @returns Rendered tooltip component
- */
-declare const A11yTooltip: (_props: AppTooltipProps) => ComponentChildren;
-export default A11yTooltip;

package/dist/apps/annotations/annotations-app.d.ts

@@ -1,4 +0,0 @@
-import type { ComponentChildren } from "preact";
-import type { AppComponentProps } from "../../types/app.d.ts";
-declare const AnnotationsApp: ({ helpers }: AppComponentProps) => ComponentChildren;
-export default AnnotationsApp;

package/dist/apps/assets/assets-app.d.ts

@@ -1,4 +0,0 @@
-import type { ComponentChildren } from "preact";
-import type { AppComponentProps } from "../../types/app.d.ts";
-declare const AssetsApp: ({ helpers }: AppComponentProps) => ComponentChildren;
-export default AssetsApp;

package/dist/apps/inspector/a11y-capture.d.ts

@@ -1,12 +0,0 @@
-interface A11yInfo {
-    ariaAttributes: Record<string, string>;
-    focusable: boolean;
-    role: string | null;
-    tabindex: number | null;
-}
-/** Collect accessibility-relevant attributes from an element. */
-declare const captureA11yInfo: (element: Element) => A11yInfo;
-/** Format A11yInfo as a plain-text summary for clipboard. */
-declare const formatA11yText: (info: A11yInfo) => string;
-export { captureA11yInfo, formatA11yText };
-export type { A11yInfo };

package/dist/apps/inspector/annotation-overlay.d.ts

@@ -1,55 +0,0 @@
-/**
- * Annotation overlay — renders annotation markers on the page canvas,
- * provides inline annotation form, detail popup, edit mode, screenshot capture,
- * freeze mode, markdown export, and SPA navigation persistence.
- *
- * All DOM elements are injected into document.body (outside Shadow DOM)
- * to match the inspector's rendering approach.
- */
-import type { Annotation } from "../../types/annotations.d.ts";
-/**
- * Returns true when the Annotations panel app is registered in the toolbar.
- */
-export declare const isAnnotationsAppEnabled: () => boolean;
-/**
- * Convert viewport click coords to page-absolute coords for storage.
- * x = percentage of viewport width, y = absolute page Y (scrollY + clientY).
- * For fixed elements, y stays as viewport-relative (no scrollY offset).
- */
-export declare const toPageCoords: (clientX: number, clientY: number, fixed?: boolean) => {
-    x: number;
-    y: number;
-};
-/** Load annotations from server and render markers. */
-export declare const loadAndShowMarkers: () => Promise<void>;
-/** Remove all annotation markers and detach listeners. */
-export declare const removeAllMarkers: () => void;
-/** Close all annotation popups (form, detail) and area outline, but keep markers. */
-export declare const closeAnnotationPopups: () => void;
-/** Whether the annotation form popup is currently open. */
-export declare const isAnnotationFormOpen: () => boolean;
-/** Shake the annotation form to draw attention. */
-export declare const shakeAnnotationForm: () => void;
-/**
- * Show annotation form popup. Captures selectedText, nearbyText, framework context,
- * and generates a smart CSS selector.
- */
-export declare const showAnnotationForm: (element: Element, rect: DOMRect, source: string | undefined, editAnnotation?: Annotation, clickPoint?: {
-    x: number;
-    y: number;
-}) => void;
-/**
- * Show annotation form for a multi-select (drag) region.
- * Creates a single annotation covering multiple elements.
- */
-export declare const showMultiSelectForm: (elements: Element[], selectionRect: DOMRect, boundingBoxes: import("../../types/annotations").BoundingBox[]) => void;
-/**
- * Show annotation form for an empty area selection (no elements found in drag region).
- * Like agentation: creates an "Area selection" annotation with the region as bounding box.
- * Shows a green dashed outline around the selected region.
- */
-export declare const showAreaSelectionForm: (selectionRect: DOMRect) => void;
-export declare const attachMarkdownShortcut: () => void;
-export declare const detachMarkdownShortcut: () => void;
-/** Check if a target is over an annotation overlay element. */
-export declare const isOverAnnotationOverlay: (target: Element | undefined) => boolean;

package/dist/apps/inspector/annotation-settings.d.ts

@@ -1,33 +0,0 @@
-/**
- * Annotation-specific settings — output detail level, marker appearance,
- * interaction behavior. Persisted in localStorage.
- */
-export type OutputDetailLevel = "compact" | "detailed" | "forensic" | "standard";
-export type MarkerClickBehavior = "delete" | "detail" | "edit";
-export interface MarkerColor {
-    /** Solid background for the marker */
-    bg: string;
-    /** Slightly darker ring / shadow tint */
-    border: string;
-    /** Text color inside the marker (white or dark for contrast) */
-    fg: string;
-    /** Translucent version for hover highlight overlay on elements */
-    highlightBg: string;
-    label: string;
-    name: string;
-}
-export declare const MARKER_COLORS: MarkerColor[];
-export interface AnnotationSettings {
-    /** Block clicks on interactive elements (buttons, links, inputs) while active */
-    blockInteractions: boolean;
-    /** What happens when you click a marker */
-    markerClickBehavior: MarkerClickBehavior;
-    /** Marker color name (from MARKER_COLORS) */
-    markerColorName: string;
-    /** Output detail level for markdown export */
-    outputDetail: OutputDetailLevel;
-}
-export declare const DEFAULT_SETTINGS: AnnotationSettings;
-export declare const loadSettings: () => AnnotationSettings;
-export declare const saveSettings: (settings: AnnotationSettings) => void;
-export declare const getMarkerColor: (settings?: AnnotationSettings) => MarkerColor;