@visulima/dev-toolbar 1.0.10 → 1.0.12

package/dist/packem_shared/{global-api.d-DeaCvII9.d.ts → global-api.d-PUBE6Od9.d.ts}

@@ -1,150 +1,139 @@
-import { D as DevToolbarApp, T as ToolbarSettings } from "./app.d-SmKEDxsI.js";
+import { D as DevToolbarApp, T as ToolbarSettings } from "./app.d-BV5WIojP.js";
 import { ViteDevServer } from 'vite';
 /**
-* Severity levels for timeline events.
-*/
+ * Severity levels for timeline events.
+ */
 type TimelineEventLevel = "info" | "warning" | "error";
 /**
-* A single captured event displayed in the timeline panel.
-*/
+ * A single captured event displayed in the timeline panel.
+ */
 interface TimelineEvent {
   /**
-  * Optional event data
-  */
+   * Optional event data
+   */
   data?: Record<string, any>;
   /**
-  * Optional duration (milliseconds)
-  */
+   * Optional duration (milliseconds)
+   */
   duration?: number;
   /**
-  * Unique event ID
-  */
+   * Unique event ID
+   */
   id: string;
   /**
-  * Event level
-  */
+   * Event level
+   */
   level?: TimelineEventLevel;
   /**
-  * Optional subtitle
-  */
+   * Optional subtitle
+   */
   subtitle?: string;
   /**
-  * Timestamp (milliseconds since epoch)
-  */
+   * Timestamp (milliseconds since epoch)
+   */
   time: number;
   /**
-  * Event title
-  */
+   * Event title
+   */
   title: string;
 }
 /**
-* A named group that holds related timeline events.
-*/
+ * A named group that holds related timeline events.
+ */
 interface TimelineGroup {
   /**
-  * Group color (hex or CSS color)
-  */
+   * Group color (hex or CSS color)
+   */
   color?: string;
   /**
-  * Events in this group
-  */
+   * Events in this group
+   */
   events: TimelineEvent[];
   /**
-  * Group ID
-  */
+   * Group ID
+   */
   id: string;
   /**
-  * Group label
-  */
+   * Group label
+   */
   label: string;
 }
 /**
-* Default timeline groups
-*/
+ * Default timeline groups
+ */
 declare const DEFAULT_TIMELINE_GROUPS: ReadonlyArray<TimelineGroup>;
 /**
-* Hook event definitions
-*/
+ * Hook event definitions
+ */
 interface HookEvents {
   [key: string]: (...args: any[]) => void;
   /**
-  * App error occurred.
-  * @param error Error object.
-  * @param appId Optional app ID where error occurred.
-  */
+   * App error occurred.
+   * @param error Error object.
+   * @param appId Optional app ID where error occurred.
+   */
   "app:error": (error: Error, appId?: string) => void;
   /**
-  * DevTools closed.
-  */
+   * DevTools closed.
+   */
   "devtools:close": () => void;
   /**
-  * DevTools initialized.
-  */
+   * DevTools initialized.
+   */
   "devtools:init": () => void;
   /**
-  * DevTools opened.
-  * @param appId ID of the opened app.
-  */
+   * DevTools opened.
+   * @param appId ID of the opened app.
+   */
   "devtools:open": (appId: string) => void;
   /**
-  * Timeline event added.
-  * @param event Timeline event.
-  */
+   * Timeline event added.
+   * @param event Timeline event.
+   */
   "timeline:event": (event: TimelineEvent) => void;
 }
 /**
-* Dev toolbar hook interface.
-* Exposed as window.__DEV_TOOLBAR_HOOK__
-*/
+ * Dev toolbar hook interface.
+ * Exposed as window.__DEV_TOOLBAR_HOOK__
+ */
 interface DevToolbarHook {
   /**
-  * Adds a timeline event.
-  * @param groupId Timeline group ID.
-  * @param event Timeline event.
-  */
+   * Adds a timeline event.
+   * @param groupId Timeline group ID.
+   * @param event Timeline event.
+   */
   addTimelineEvent: (groupId: string, event: TimelineEvent) => void;
   /**
-  * Emits an event.
-  * @param event Event name.
-  * @param args Event arguments.
-  */
+   * Emits an event.
+   * @param event Event name.
+   * @param args Event arguments.
+   */
   emit: <T extends keyof HookEvents>(event: T, ...args: Parameters<HookEvents[T]>) => void;
   /**
-  * Unsubscribes from an event.
-  * @param event Event name.
-  * @param handler Optional specific handler to remove.
-  */
+   * Unsubscribes from an event.
+   * @param event Event name.
+   * @param handler Optional specific handler to remove.
+   */
   off: <T extends keyof HookEvents>(event: T, handler?: HookEvents[T]) => void;
   /**
-  * Subscribes to an event.
-  * @param event Event name.
-  * @param handler Event handler.
-  * @returns Unsubscribe function.
-  */
+   * Subscribes to an event.
+   * @param event Event name.
+   * @param handler Event handler.
+   * @returns Unsubscribe function.
+   */
   on: <T extends keyof HookEvents>(event: T, handler: HookEvents[T]) => () => void;
   /**
-  * Subscribes to an event once.
-  * @param event Event name.
-  * @param handler Event handler.
-  */
+   * Subscribes to an event once.
+   * @param event Event name.
+   * @param handler Event handler.
+   */
   once: <T extends keyof HookEvents>(event: T, handler: HookEvents[T]) => void;
   /**
-  * Registers a custom app.
-  * @param app App definition.
-  */
+   * Registers a custom app.
+   * @param app App definition.
+   */
   registerApp: (app: DevToolbarApp) => void;
 }
-/**
-* Global hook declaration
-*/
-declare global$1 {
-  interface Window {
-    /**
-    * Dev toolbar hook for library integrations.
-    */
-    __DEV_TOOLBAR_HOOK__?: DevToolbarHook;
-  }
-}
 interface StaticAsset {
   /** Last-modified timestamp (ms since epoch) */
   mtime: number;
@@ -172,20 +161,20 @@ interface TailwindConfigResult {
   version: "v3" | "v4" | "unknown";
 }
 /**
-* Annotation intent — describes what the user wants to communicate.
-*/
+ * Annotation intent — describes what the user wants to communicate.
+ */
 type AnnotationIntent = "approve" | "change" | "fix" | "question";
 /**
-* Annotation severity — how urgent or important the annotation is.
-*/
+ * Annotation severity — how urgent or important the annotation is.
+ */
 type AnnotationSeverity = "blocking" | "important" | "suggestion";
 /**
-* Annotation status — lifecycle state.
-*/
+ * Annotation status — lifecycle state.
+ */
 type AnnotationStatus = "acknowledged" | "dismissed" | "pending" | "resolved";
 /**
-* A single message in a conversation thread attached to an annotation.
-*/
+ * A single message in a conversation thread attached to an annotation.
+ */
 interface ThreadMessage {
   /** Message text */
   content: string;
@@ -197,8 +186,8 @@ interface ThreadMessage {
   timestamp: string;
 }
 /**
-* Bounding box of the annotated element relative to the viewport.
-*/
+ * Bounding box of the annotated element relative to the viewport.
+ */
 interface BoundingBox {
   height: number;
   width: number;
@@ -206,8 +195,8 @@ interface BoundingBox {
   y: number;
 }
 /**
-* Detected framework component information.
-*/
+ * Detected framework component information.
+ */
 interface FrameworkContext {
   /** Component name */
   componentName?: string;
@@ -223,8 +212,8 @@ interface FrameworkContext {
   sourceLine?: number;
 }
 /**
-* Captured accessibility attributes for an element.
-*/
+ * Captured accessibility attributes for an element.
+ */
 interface AccessibilityInfo {
   /** aria-describedby content */
   ariaDescribedBy?: string;
@@ -238,9 +227,9 @@ interface AccessibilityInfo {
   tabindex?: number;
 }
 /**
-* A visual annotation placed on a page element during development.
-* Stored in `.devtoolbar/annotations.json`.
-*/
+ * A visual annotation placed on a page element during development.
+ * Stored in `.devtoolbar/annotations.json`.
+ */
 interface Annotation {
   /** Captured accessibility attributes */
   accessibility?: AccessibilityInfo;
@@ -301,18 +290,18 @@ interface Annotation {
   /** 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.
-  */
+   * 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).
-*/
+ * 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.
-*/
+ * Fields that can be updated on an existing annotation.
+ */
 interface UpdateAnnotationData {
   /** Updated comment text */
   comment?: string;
@@ -328,218 +317,231 @@ interface UpdateAnnotationData {
   threadMessage?: ThreadMessage;
 }
 /**
-* Server-side RPC functions
-* These can be called from the client
-*/
+ * Server-side RPC functions
+ * These can be called from the client
+ */
 interface ServerFunctions {
   /**
-  * Extension point for custom server functions
-  */
+   * Extension point for custom server functions
+   */
   [key: string]: (...args: any[]) => Promise<any>;
   /**
-  * Create a new annotation
-  * @param data Annotation data (id, timestamps, status are generated server-side)
-  */
+   * Create a new annotation
+   * @param data Annotation data (id, timestamps, status are generated server-side)
+   */
   createAnnotation: (data: CreateAnnotationData) => Promise<Annotation>;
   /**
-  * Delete an annotation and its screenshot
-  * @param id Annotation ID
-  */
+   * Delete an annotation and its screenshot
+   * @param id Annotation ID
+   */
   deleteAnnotation: (id: string) => Promise<boolean>;
   /**
-  * Get all annotations
-  */
+   * Get all annotations
+   */
   getAnnotations: () => Promise<Annotation[]>;
   /**
-  * Get module dependency graph
-  */
+   * Get module dependency graph
+   */
   getModuleGraph: () => Promise<SerializableModuleNode[]>;
   /**
-  * Get a screenshot as a base64 data URL
-  * @param annotationId Annotation ID
-  */
+   * Get a screenshot as a base64 data URL
+   * @param annotationId Annotation ID
+   */
   getScreenshot: (annotationId: string) => Promise<string | null>;
   /**
-  * Get all static assets from the public directory
-  */
+   * Get all static assets from the public directory
+   */
   getStaticAssets: () => Promise<StaticAsset[]>;
   /**
-  * Get full Tailwind CSS theme (default + user overrides)
-  */
+   * Get full Tailwind CSS theme (default + user overrides)
+   */
   getTailwindConfig: () => Promise<TailwindConfigResult>;
   /**
-  * Get Vite configuration
-  */
+   * Get Vite configuration
+   */
   getViteConfig: () => Promise<Record<string, any>>;
   /**
-  * Open file in editor
-  * @param file File path
-  * @param line Line number (1-based)
-  * @param column Column number (1-based)
-  */
+   * Open file in editor
+   * @param file File path
+   * @param line Line number (1-based)
+   * @param column Column number (1-based)
+   */
   openInEditor: (file: string, line?: number, column?: number) => Promise<void>;
   /**
-  * Read file contents
-  * @param path File path
-  */
+   * Read file contents
+   * @param path File path
+   */
   readFile: (path: string) => Promise<string>;
   /**
-  * Save a screenshot for an annotation
-  * @param annotationId Annotation ID
-  * @param dataUrl Base64 data URL (PNG, JPEG, WebP, or SVG)
-  * @returns Relative path within .devtoolbar/
-  */
+   * Save a screenshot for an annotation
+   * @param annotationId Annotation ID
+   * @param dataUrl Base64 data URL (PNG, JPEG, WebP, or SVG)
+   * @returns Relative path within .devtoolbar/
+   */
   saveScreenshot: (annotationId: string, dataUrl: string) => Promise<string>;
   /**
-  * Update an existing annotation
-  * @param id Annotation ID
-  * @param data Fields to update
-  */
+   * Update an existing annotation
+   * @param id Annotation ID
+   * @param data Fields to update
+   */
   updateAnnotation: (id: string, data: UpdateAnnotationData) => Promise<Annotation | null>;
 }
 /**
-* Client-side RPC functions
-* These can be called from the server
-*/
+ * Client-side RPC functions
+ * These can be called from the server
+ */
 interface ClientFunctions {
   [key: string]: (...args: any[]) => void;
   /**
-  * Notify client of config change
-  * @param config New Vite config
-  */
+   * Notify client of config change
+   * @param config New Vite config
+   */
   onConfigChange: (config: Record<string, unknown>) => void;
   /**
-  * Notify client of HMR update
-  * @param payload HMR payload
-  */
+   * Notify client of HMR update
+   * @param payload HMR payload
+   */
   onHMRUpdate: (payload: unknown) => void;
   /**
-  * Notify client of module update
-  * @param module Updated module node
-  */
+   * Notify client of module update
+   * @param module Updated module node
+   */
   onModuleUpdate: (module: SerializableModuleNode) => void;
 }
 /**
-* RPC context for server-side
-*/
+ * RPC context for server-side
+ */
 interface ServerRPCContext {
   /**
-  * Call a client function
-  * @param name Function name
-  * @param args Function arguments
-  */
+   * Call a client function
+   * @param name Function name
+   * @param args Function arguments
+   */
   callClient: <K extends keyof ClientFunctions>(name: K, ...args: Parameters<ClientFunctions[K]>) => void;
   /**
-  * Register a server function
-  * @param name Function name
-  * @param fn Function implementation
-  */
+   * Register a server function
+   * @param name Function name
+   * @param fn Function implementation
+   */
   registerFunction: <K extends keyof ServerFunctions>(name: K, function_: ServerFunctions[K]) => void;
   /**
-  * Vite dev server instance
-  */
+   * Vite dev server instance
+   */
   server: ViteDevServer;
 }
 /**
-* RPC context for client-side
-*/
+ * RPC context for client-side
+ */
 interface ClientRPCContext {
   /**
-  * Call a server function
-  * @param name Function name
-  * @param args Function arguments
-  */
+   * Call a server function
+   * @param name Function name
+   * @param args Function arguments
+   */
   callServer: <K extends keyof ServerFunctions>(name: K, ...args: Parameters<ServerFunctions[K]>) => Promise<ReturnType<ServerFunctions[K]>>;
   /**
-  * Register a client function
-  * @param name Function name
-  * @param function_ Function implementation
-  */
+   * Register a client function
+   * @param name Function name
+   * @param function_ Function implementation
+   */
   registerFunction: <K extends keyof ClientFunctions>(name: K, function_: ClientFunctions[K]) => void;
 }
 /**
-* Global DevTools API interface.
-* Exposed as window.__VISULIMA_DEVTOOLS__
-*/
+ * Global DevTools API interface.
+ * Exposed as window.__VISULIMA_DEVTOOLS__
+ */
 interface VisulimaDevTools {
   /**
-  * Clears notification for an app.
-  */
+   * Clears notification for an app.
+   */
   clearNotification: (appId: string) => void;
   /**
-  * Closes the currently active app.
-  */
+   * Closes the currently active app.
+   */
   closeApp: () => Promise<void>;
   /**
-  * Gets the currently active app ID.
-  */
+   * Gets the currently active app ID.
+   */
   getActiveApp: () => string | undefined;
   /**
-  * Gets all registered apps.
-  */
+   * Gets all registered apps.
+   */
   getApps: () => DevToolbarApp[];
   /**
-  * Gets current toolbar settings.
-  */
+   * Gets current toolbar settings.
+   */
   getSettings: () => ToolbarSettings;
   /**
-  * Hides the toolbar.
-  */
+   * Hides the toolbar.
+   */
   hide: () => void;
   /**
-  * Hook instance for event subscriptions.
-  */
+   * Hook instance for event subscriptions.
+   */
   hook: DevToolbarHook;
   /**
-  * Shows a notification for an app.
-  */
+   * Shows a notification for an app.
+   */
   notify: (appId: string, level: "info" | "warning" | "error") => void;
   /**
-  * Opens an app by ID.
-  */
+   * Opens an app by ID.
+   */
   openApp: (appId: string) => Promise<void>;
   /**
-  * Registers a custom app.
-  */
+   * Registers a custom app.
+   */
   registerApp: (app: DevToolbarApp) => void;
   /**
-  * RPC client for calling server functions.
-  */
+   * RPC client for calling server functions.
+   */
   rpc: ServerFunctions;
   /**
-  * Directly sets the active state of an action button without invoking callbacks.
-  * Useful for deactivating a button from async work running outside the toolbar.
-  */
+   * Directly sets the active state of an action button without invoking callbacks.
+   * Useful for deactivating a button from async work running outside the toolbar.
+   */
   setAppActive: (appId: string, active: boolean) => void;
   /**
-  * Shows the toolbar.
-  */
+   * Shows the toolbar.
+   */
   show: () => void;
   /**
-  * Toggles toolbar visibility.
-  */
+   * Toggles toolbar visibility.
+   */
   toggle: () => void;
   /**
-  * Unregisters an app by ID.
-  */
+   * Unregisters an app by ID.
+   */
   unregisterApp: (appId: string) => void;
   /**
-  * Updates toolbar settings.
-  */
+   * Updates toolbar settings.
+   */
   updateSettings: (settings: Partial<ToolbarSettings>) => void;
   /**
-  * Package version.
-  */
+   * Package version.
+   */
   version: string;
 }
 /**
-* Global API declaration
-*/
+ * Global `Window` augmentation for the whole package.
+ *
+ * Every `declare global` this package ships must live in this one block.
+ * packem's .d.ts bundler treats `global` as an ordinary identifier when
+ * de-duplicating declarations, so a second `declare global` in another
+ * bundled module is emitted as `declare global$1` — invalid TypeScript
+ * (TS1435), and *not* suppressed by `skipLibCheck` because it is a
+ * grammar error rather than a type error. That breaks every consumer's
+ * build. Keep additions here rather than adding a block next to the
+ * interface they relate to.
+ */
 declare global {
   interface Window {
     /**
-    * Visulima DevTools global API.
-    */
+     * Dev toolbar hook for library integrations.
+     */
+    __DEV_TOOLBAR_HOOK__?: DevToolbarHook;
+    /**
+     * Visulima DevTools global API.
+     */
     __VISULIMA_DEVTOOLS__?: VisulimaDevTools;
   }
 }