@qwik.dev/devtools 0.2.7 → 0.3.0-beta.3

package/LICENSE

@@ -1,6 +1,7 @@
 MIT License
 
-Copyright (c) 2023 qwikdev
+Copyright (c) 2024 QwikDev
+Copyright (c) 2021 BuilderIO
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/kit/index.d.mts

@@ -0,0 +1,568 @@
+import { BirpcReturn } from "birpc";
+import { Dree, Type as RouteType } from "dree";
+import { ViteDevServer } from "vite";
+
+//#region kit/src/protocol/messages.d.ts
+declare const DEVTOOLS_MESSAGES: {
+  readonly pageSource: "qwik-devtools";
+  readonly viteMessagingEvent: "qwik_tools:vite_messaging_event";
+  readonly types: {
+    readonly render: "RENDER_EVENT";
+    readonly componentTreeUpdate: "COMPONENT_TREE_UPDATE";
+  };
+  readonly events: {
+    readonly preloadsUpdate: "qwik:preloads-update";
+    readonly ssrPerf: "qwik:ssr-perf";
+    readonly ssrPreloads: "qwik:ssr-preloads";
+  };
+};
+interface QwikDevtoolsPageMessage<TType extends string = string, TPayload = unknown> {
+  source: typeof DEVTOOLS_MESSAGES.pageSource;
+  type: TType;
+  event?: TPayload;
+  tree?: TPayload;
+}
+//#endregion
+//#region kit/src/protocol/hooks.d.ts
+declare const HOOK_GROUPS: {
+  readonly variableDeclaration: readonly ["useStore", "useSignal", "useComputed", "useAsyncComputed", "useContext", "useId", "useStyles", "useStylesScoped", "useConstant", "useErrorBoundary", "useSerializer", "useServerData", "useLocation", "useNavigate", "useContent", "useDocumentHead"];
+  readonly expressionStatement: readonly ["useVisibleTask", "useTask", "useResource", "useContextProvider", "usePreventNavigate"];
+  readonly listener: readonly ["useOn", "useOnDocument", "useOnWindow"];
+  readonly noReturn: readonly ["useVisibleTask", "useTask"];
+};
+declare const VARIABLE_DECLARATION_LIST: readonly ["useStore", "useSignal", "useComputed", "useAsyncComputed", "useContext", "useId", "useStyles", "useStylesScoped", "useConstant", "useErrorBoundary", "useSerializer", "useServerData", "useLocation", "useNavigate", "useContent", "useDocumentHead"];
+declare const EXPRESSION_STATEMENT_LIST: readonly ["useVisibleTask", "useTask", "useResource", "useContextProvider", "usePreventNavigate"];
+declare const USE_HOOK_LIST: readonly ["useStore", "useSignal", "useComputed", "useAsyncComputed", "useContext", "useId", "useStyles", "useStylesScoped", "useConstant", "useErrorBoundary", "useSerializer", "useServerData", "useLocation", "useNavigate", "useContent", "useDocumentHead", "useOn", "useOnDocument", "useOnWindow", "useVisibleTask", "useTask", "useResource", "useContextProvider", "usePreventNavigate"];
+declare const NORETURN_HOOK: readonly ["useVisibleTask", "useTask"];
+declare const SIGNAL_HOOK_TYPES: readonly ["useSignal", "useStore", "useComputed", "useAsyncComputed", "useContext"];
+/**
+ * A single component hook entry with deeply serialized data, returned by the devtools hook's
+ * component detail lookup. Shared data contract: do not redeclare in consumers, import it from
+ * here.
+ */
+interface DevtoolsComponentDetailEntry {
+  hookType: string;
+  variableName: string;
+  data: unknown;
+}
+declare const INNER_USE_HOOK = "useCollectHooks";
+declare const VIRTUAL_QWIK_DEVTOOLS_KEY = "virtual-qwik-devtools.ts";
+declare const QWIK_DEVTOOLS_HOOK_VERSION = 1;
+//#endregion
+//#region kit/src/protocol/vnode.d.ts
+declare const QWIK_VNODE_PROTOCOL: {
+  readonly attrs: {
+    readonly seq: "q:seq";
+    readonly props: "q:props";
+    readonly renderFn: "q:renderFn";
+    readonly type: "q:type";
+    readonly id: "q:id";
+    readonly key: "q:key";
+    readonly colon: ":";
+  };
+  readonly qrl: {
+    readonly qrl: "$qrl$";
+    readonly computed: "$computeQrl$";
+    readonly chunk: "$chunk$";
+    readonly symbol: "$symbol$";
+    readonly captureRef: "$captureRef$";
+    readonly untrackedValue: "$untrackedValue$";
+  };
+  readonly bridgeVirtualModuleId: "virtual:qwik-devtools-bridge";
+};
+/**
+ * Serializable VNode tree node exchanged between the page hook and the devtools UI/extension.
+ * Shared data contract: do not redeclare in consumers, import it from here.
+ */
+interface DevtoolsVNodeTreeNode {
+  name?: string;
+  id: string;
+  label?: string;
+  props?: Record<string, unknown>;
+  children?: DevtoolsVNodeTreeNode[];
+}
+//#endregion
+//#region kit/src/protocol/globals.d.ts
+declare const QWIK_DEVTOOLS_GLOBAL: {
+  readonly key: "__QWIK_DEVTOOLS__";
+  readonly version: 1;
+  readonly props: {
+    readonly componentState: "componentState";
+    readonly hook: "hook";
+    readonly pageDataSource: "pageDataSource";
+    readonly dataProvider: "dataProvider";
+    readonly perf: "perf";
+    readonly preloads: "preloads";
+    readonly ssrPreloads: "ssrPreloads";
+  };
+  readonly ssr: {
+    readonly perfStore: "__QWIK_SSR_PERF__";
+    readonly preloadsProcessStore: "__QWIK_SSR_PRELOADS__";
+    readonly perfId: "__QWIK_SSR_PERF_ID__";
+    readonly perfIndex: "__QWIK_SSR_PERF_INDEX__";
+    readonly perfCount: "__QWIK_SSR_PERF_COUNT__";
+  };
+};
+//#endregion
+//#region kit/src/types.d.ts
+interface ClientFunctions {
+  healthCheck(): boolean;
+}
+interface DependenciesStatus {
+  phase: 'idle' | 'phase1' | 'phase2' | 'done' | 'error';
+  loaded: number;
+  total: number;
+  startedAt: number | null;
+  finishedAt: number | null;
+  error?: string;
+}
+interface PackageInstallResult {
+  success: boolean;
+  error?: string;
+}
+type DependencyType = 'dependencies' | 'devDependencies' | 'peerDependencies';
+type InstallDependencyType = 'dependencies' | 'devDependencies';
+type DependencyVersionStatus = 'latest' | 'outdated' | 'unknown' | 'error';
+interface DependencyAuthor {
+  name?: string;
+  email?: string;
+  url?: string;
+}
+interface DependencyInfo {
+  name: string;
+  requestedVersion: string;
+  currentVersion: string;
+  latestVersion?: string;
+  type: DependencyType;
+  status: DependencyVersionStatus;
+  description: string;
+  author?: string | DependencyAuthor;
+  homepage?: string;
+  repository?: string;
+  npmUrl: string;
+  iconUrl?: string | null;
+}
+interface PackageSearchResult {
+  name: string;
+  latestVersion: string;
+  description: string;
+  author?: string | DependencyAuthor;
+  npmUrl: string;
+  isInstalled: boolean;
+  installedVersion?: string;
+}
+interface PackageSearchResponse {
+  results: PackageSearchResult[];
+  error?: string;
+}
+interface DependencyOperationResult {
+  success: boolean;
+  action: 'install' | 'update';
+  packageName: string;
+  error?: string;
+}
+interface BuildAnalysisStatus {
+  exists: boolean;
+  reportPath: string;
+  buildCommand: string | null;
+  canTriggerBuild: boolean;
+  buildTriggerHint?: string;
+}
+interface BuildAnalysisRunResult {
+  success: boolean;
+  error?: string;
+}
+interface ModuleLookupResult {
+  pathId: string;
+  modules: any;
+  error?: string;
+}
+type ParsedQwikCodeResult = Omit<ParsedStructure, '__start__'>[];
+interface ServerFunctions {
+  healthCheck(): boolean;
+  getAssetsFromPublicDir: () => Promise<AssetInfo[]>;
+  getComponents: () => Promise<Component[]>;
+  getRoutes: () => any;
+  getQwikPackages: () => Promise<[string, string][]>;
+  getAllDependencies: () => Promise<DependencyInfo[]>;
+  getDependenciesStatus: () => Promise<DependenciesStatus>;
+  refreshDependencies: () => Promise<DependencyInfo[]>;
+  searchPackages: (query: string) => Promise<PackageSearchResponse>;
+  installPackage: (packageName: string, dependencyType: InstallDependencyType) => Promise<DependencyOperationResult>;
+  updatePackage: (packageName: string) => Promise<DependencyOperationResult>;
+  getBuildAnalysisStatus: () => Promise<BuildAnalysisStatus>;
+  buildBuildAnalysisReport: () => Promise<BuildAnalysisRunResult>;
+  getModulesByPathIds: (pathIds: string | string[]) => Promise<ModuleLookupResult[]>;
+  parseQwikCode: (code: string) => Promise<ParsedQwikCodeResult>;
+}
+type ServerRpc = BirpcReturn<ClientFunctions, ServerFunctions>;
+type ClientRpc = BirpcReturn<ServerFunctions, ClientFunctions>;
+type AssetType = 'image' | 'font' | 'video' | 'audio' | 'text' | 'json' | 'wasm' | 'other';
+interface AssetInfo {
+  path: string;
+  type: AssetType;
+  publicPath: string;
+  relativePath: string;
+  filePath: string;
+  size: number;
+  mtime: number;
+}
+interface ImageMeta {
+  width: number;
+  height: number;
+  orientation?: number;
+  type?: string;
+  mimeType?: string;
+}
+type RoutesInfo = Dree;
+type NpmInfo = [string, string][];
+interface Component {
+  name: string;
+  fileName: string;
+  file: string;
+}
+type Category = 'variableDeclaration' | 'expressionStatement' | 'listener';
+type HookType = (typeof VARIABLE_DECLARATION_LIST)[number] | (typeof EXPRESSION_STATEMENT_LIST)[number] | 'customhook';
+interface ParsedStructure {
+  variableName: string;
+  hookType: HookType;
+  category: Category;
+  __start__?: number;
+  data?: any;
+}
+//#endregion
+//#region kit/src/client.d.ts
+declare function createClientRpc(functions: ClientFunctions): void;
+//#endregion
+//#region kit/src/hook-types.d.ts
+/**
+ * Runtime devtools hook exposed on `window.__QWIK_DEVTOOLS__.hook` by the `@devtools/plugin` in dev
+ * mode.
+ *
+ * Provides structured access to component state, signals, and render events for both the in-app
+ * overlay and the browser extension.
+ */
+interface QwikDevtoolsHook {
+  /** Hook API version. Consumers must check this before using the API. */
+  version: 1;
+  /**
+   * Read the current value of a signal reference. Only works in-page (not serializable for
+   * extension eval).
+   */
+  getSignalValue(signal: unknown): unknown;
+  /** Return a serializable snapshot of all tracked signals grouped by component source path. */
+  getSignalsSnapshot(): QwikDevtoolsSignalsSnapshot;
+  /**
+   * Return a serializable snapshot of all tracked components with their hooks and current signal
+   * values.
+   */
+  getComponentTreeSnapshot(): QwikDevtoolsComponentSnapshot[];
+  /** Subscribe to CSR render events. Returns an unsubscribe function. */
+  onRender(callback: (info: QwikDevtoolsRenderEvent) => void): () => void;
+  /**
+   * Subscribe to signal value changes. Returns an unsubscribe function.
+   *
+   * Note: v1 does not implement real-time signal tracking. Consumers should poll
+   * {@link getSignalsSnapshot} and diff.
+   */
+  onSignalUpdate(callback: (info: QwikDevtoolsSignalEvent) => void): () => void;
+}
+/** Serializable signal snapshot grouped by component path. */
+type QwikDevtoolsSignalsSnapshot = Record<string, QwikDevtoolsSignalEntry[]>;
+/** A single tracked signal entry. */
+interface QwikDevtoolsSignalEntry {
+  name: string;
+  hookType: string;
+  value: unknown;
+}
+/** Serializable component snapshot. */
+interface QwikDevtoolsComponentSnapshot {
+  /** Source path (e.g. `src/routes/index.tsx_Counter`) */
+  path: string;
+  /** Short display name */
+  name: string;
+  /** Tracked signals with current values */
+  signals: QwikDevtoolsSignalEntry[];
+  /** All hook metadata */
+  hooks: Array<{
+    variableName: string;
+    hookType: string;
+    category: string;
+  }>;
+}
+/** Emitted when a component renders (CSR only). */
+interface QwikDevtoolsRenderEvent {
+  component: string;
+  phase: 'ssr' | 'csr';
+  duration: number;
+  timestamp: number;
+}
+/** Emitted when a signal value changes. */
+interface QwikDevtoolsSignalEvent {
+  componentPath: string;
+  signalName: string;
+  oldValue: unknown;
+  newValue: unknown;
+  timestamp: number;
+}
+//#endregion
+//#region kit/src/globals.d.ts
+interface EventEmitter {
+  on: (name: string, handler: (data: any) => void) => void;
+  send: (name: string, ...args: any[]) => void;
+}
+interface ViteClientContext extends EventEmitter {}
+type ViteServerContext = ViteDevServer;
+declare const CLIENT_CTX = "__qwik_client_ctx__";
+declare const SERVER_CTX = "__qwik_server_ctx__";
+declare const SERVER_RPC = "__qwik_server_rpc__";
+declare const CLIENT_RPC = "__qwik_client_rpc__";
+type QwikPerfPhaseRemembered = 'ssr' | 'csr';
+interface QwikPerfErrorRemembered {
+  name: string;
+  message: string;
+}
+interface QwikPerfEntryRemembered {
+  id: number;
+  component: string;
+  phase: QwikPerfPhaseRemembered;
+  duration: number;
+  start: number;
+  end: number;
+  error?: QwikPerfErrorRemembered;
+  /** Present for wrapped `_component_` render-function modules; helps de-dupe. */
+  viteId?: string;
+  /** Present for wrapped `_component_` render-function modules. */
+  renderCount?: number;
+}
+interface QwikPerfStoreRemembered {
+  ssr: QwikPerfEntryRemembered[];
+  csr: QwikPerfEntryRemembered[];
+}
+type QwikPreloadStatus = 'pending' | 'loaded' | 'error' | 'unknown';
+type QwikPreloadSource = 'initial-dom' | 'mutation' | 'performance' | 'qrl-correlation';
+type QwikPreloadOriginKind = 'current-project' | 'vite-plugin-injected' | 'node_modules' | 'virtual-module' | 'generated' | 'external' | 'unknown';
+type QwikPreloadPhase = 'csr' | 'ssr' | 'unknown';
+type QwikPreloadMatchMode = 'href' | 'normalized-href' | 'chunk-hash' | 'resource-name' | 'none';
+type QwikPreloadLoadMatchQuality = 'best-effort' | 'none';
+interface QwikPreloadQrlRequestRemembered {
+  symbol: string;
+  href?: string;
+  normalizedHref?: string;
+  requestedAt: number;
+  originKind?: QwikPreloadOriginKind;
+  phase?: QwikPreloadPhase;
+  matchedEntryId?: number;
+}
+interface QwikPreloadEntryRemembered {
+  id: number;
+  href: string;
+  normalizedHref: string;
+  rel: string;
+  as: string;
+  resourceType: string;
+  status: QwikPreloadStatus;
+  source: QwikPreloadSource;
+  originKind: QwikPreloadOriginKind;
+  phase: QwikPreloadPhase;
+  discoveredAt: number;
+  requestedAt?: number;
+  completedAt?: number;
+  importDuration?: number;
+  loadDuration?: number;
+  duration?: number;
+  transferSize?: number;
+  decodedBodySize?: number;
+  initiatorType?: string;
+  qrlSymbol?: string;
+  qrlRequestedAt?: number;
+  qrlToLoadDuration?: number;
+  loadMatchQuality?: QwikPreloadLoadMatchQuality;
+  matchedBy: QwikPreloadMatchMode;
+  error?: string;
+}
+type QwikSsrPreloadSnapshotRemembered = Partial<QwikPreloadEntryRemembered> & Pick<QwikPreloadEntryRemembered, 'href'>;
+interface QwikPreloadStoreRemembered {
+  entries: QwikPreloadEntryRemembered[];
+  qrlRequests: QwikPreloadQrlRequestRemembered[];
+  startedAt: number;
+  clear: () => void;
+  _id: number;
+  _initialized: boolean;
+  _byHref: Record<string, number>;
+  _byId: Record<number, QwikPreloadEntryRemembered>;
+}
+interface DevtoolsRenderStats {
+  /**
+   * In-memory performance store written by devtools instrumentation. (Populated at runtime;
+   * optional in types.)
+   */
+  perf?: QwikPerfStoreRemembered;
+}
+interface ComponentDevtoolsState {
+  hooks: ParsedStructure[];
+  stats: DevtoolsRenderStats;
+}
+interface QwikDevtoolsWindowGlobal {
+  version: number;
+  componentState?: Record<string, ComponentDevtoolsState>;
+  perf?: QwikPerfStoreRemembered;
+  preloads?: QwikPreloadStoreRemembered;
+  ssrPreloads?: QwikSsrPreloadSnapshotRemembered[];
+  hook?: QwikDevtoolsHook;
+  dataProvider?: unknown;
+  pageDataSource?: unknown;
+}
+declare global {
+  interface Window {
+    /**
+     * Single page-scoped Qwik DevTools root. All browser-visible devtools state lives under this
+     * object rather than as independent `window` properties.
+     */
+    __QWIK_DEVTOOLS__?: QwikDevtoolsWindowGlobal;
+  }
+}
+declare global {
+  namespace NodeJS {
+    interface Process {
+      __QWIK_SSR_PERF__?: QwikPerfEntryRemembered[];
+      __QWIK_SSR_PRELOADS__?: QwikSsrPreloadSnapshotRemembered[];
+      __QWIK_SSR_PERF_SET__?: Set<string>;
+      __QWIK_SSR_PERF_ID__?: number;
+      __QWIK_SSR_PERF_INDEX__?: Record<string, number>;
+    }
+  }
+}
+//#endregion
+//#region kit/src/protocol/perf.d.ts
+declare const PERF_VIRTUAL_MODULE_ID = "virtual:qwik-component-proxy";
+declare const PERF_PHASE_SSR = "ssr";
+declare const PERF_PHASE_CSR = "csr";
+declare const DEFAULT_PERF_STORE_EXPRESSION = "{ ssr: [], csr: [] }";
+type QwikDevtoolsPerfPhase = typeof PERF_PHASE_SSR | typeof PERF_PHASE_CSR;
+/**
+ * A single render event emitted by the performance runtime (CSR render with timing). Shared data
+ * contract: do not redeclare in consumers, import it from here.
+ */
+interface DevtoolsRenderEvent {
+  component: string;
+  phase: string;
+  duration: number;
+  timestamp: number;
+}
+//#endregion
+//#region kit/src/client-bridge.d.ts
+interface InPageBridgeOptions {
+  isBrowser: boolean;
+}
+interface InPageBridge {
+  readPerfData(): Promise<QwikPerfStoreRemembered | null>;
+  readPreloadStore(): Promise<QwikPreloadStoreRemembered | null>;
+  clearPreloadStore(): Promise<void>;
+  subscribePreloadUpdates(cb: () => void): (() => void) | null;
+  readComponentTree(): Promise<QwikDevtoolsComponentSnapshot[] | null>;
+  readSignals(): Promise<QwikDevtoolsSignalsSnapshot | null>;
+  readVNodeTree(): Promise<DevtoolsVNodeTreeNode[] | null>;
+  subscribeTreeUpdates(cb: (tree: DevtoolsVNodeTreeNode[]) => void): (() => void) | null;
+  readComponentDetail(componentName: string, qrlChunk?: string): Promise<DevtoolsComponentDetailEntry[] | null>;
+  readNodeProps(nodeId: string): Promise<Record<string, unknown> | null>;
+  setSignalValue(componentName: string, qrlChunk: string | undefined, variableName: string, newValue: unknown): Promise<boolean>;
+  subscribeRenderEvents(cb: (event: DevtoolsRenderEvent) => void): (() => void) | null;
+}
+/**
+ * Page-level data access contract shared by the in-app overlay (same window) and the browser
+ * extension panel (reads the inspected page via chrome.devtools eval). Both implementations depend
+ * on this shape so a change to one side is type-checked against the other.
+ */
+interface PageDataSource {
+  readPerfData(): Promise<QwikPerfStoreRemembered | null>;
+  readPreloadStore(): Promise<QwikPreloadStoreRemembered | null>;
+  clearPreloadStore(): Promise<void>;
+  /** Returns an unsubscribe fn, or null when live subscriptions are unsupported (extension polls). */
+  subscribePreloadUpdates(cb: () => void): (() => void) | null;
+  readComponentTree(): Promise<QwikDevtoolsComponentSnapshot[] | null>;
+  readSignals(): Promise<QwikDevtoolsSignalsSnapshot | null>;
+  readVNodeTree(): Promise<DevtoolsVNodeTreeNode[] | null>;
+  subscribeTreeUpdates(cb: (tree: DevtoolsVNodeTreeNode[]) => void): (() => void) | null;
+  readComponentDetail(componentName: string, qrlChunk?: string): Promise<DevtoolsComponentDetailEntry[] | null>;
+  readNodeProps(nodeId: string): Promise<Record<string, unknown> | null>;
+  setSignalValue(componentName: string, qrlChunk: string | undefined, variableName: string, newValue: unknown): Promise<boolean>;
+  /** Highlight a component's DOM element on the page by its VNode tree node id. */
+  highlightElement(nodeId: string, componentName: string): Promise<void>;
+  unhighlightElement(): Promise<void>;
+  subscribeRenderEvents(cb: (event: DevtoolsRenderEvent) => void): (() => void) | null;
+}
+/** Full page-side hook surface (runtime hook plus vnode bridge methods) callers reference by name. */
+interface QwikDevtoolsHookExtended extends QwikDevtoolsHook {
+  getComponentDetail(name: string, chunk?: string): DevtoolsComponentDetailEntry[] | null;
+  setSignalValue(name: string, chunk: string | undefined, varName: string, val: unknown): boolean;
+  getVNodeTree?(): DevtoolsVNodeTreeNode[] | null;
+  getNodeProps?(nodeId: string): Record<string, unknown> | null;
+  resolveElementToComponent?(el: Element | null): string | null;
+  getElementRect?(nodeId: string): {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+  } | null;
+  highlightNode?(nodeId: string, componentName: string): void;
+  unhighlightNode?(): void;
+}
+declare function createInPageBridge(options: InPageBridgeOptions): InPageBridge;
+//#endregion
+//#region kit/src/server.d.ts
+interface ServerRpcRequestContext {
+  client?: unknown;
+}
+declare function getServerRpcRequestContext(): ServerRpcRequestContext | undefined;
+declare function createServerRpc(functions: ServerFunctions): void;
+//#endregion
+//#region kit/src/context.d.ts
+declare const getViteClientContext: () => ViteClientContext;
+declare const setViteClientContext: (value: ViteClientContext) => void;
+declare const getViteServerContext: () => import("vite").ViteDevServer;
+declare const setViteServerContext: (value: import("vite").ViteDevServer) => void;
+declare const getViteServerRpc: () => import("birpc").ProxifiedRemoteFunctions<ClientFunctions> & import("birpc").BirpcReturnBuiltin<ClientFunctions, ServerFunctions>;
+declare const setViteServerRpc: (value: import("birpc").ProxifiedRemoteFunctions<ClientFunctions> & import("birpc").BirpcReturnBuiltin<ClientFunctions, ServerFunctions>) => void;
+declare const getViteClientRpc: () => import("birpc").ProxifiedRemoteFunctions<ServerFunctions> & import("birpc").BirpcReturnBuiltin<ServerFunctions, ClientFunctions>;
+declare const setViteClientRpc: (value: import("birpc").ProxifiedRemoteFunctions<ServerFunctions> & import("birpc").BirpcReturnBuiltin<ServerFunctions, ClientFunctions>) => void;
+//#endregion
+//#region kit/src/global-store.d.ts
+declare function createGlobalAccessor<T>(key: string): {
+  get: () => T;
+  set: (value: T) => void;
+};
+declare function getQwikDevtoolsGlobal(pageWindow?: Window | undefined | null): QwikDevtoolsWindowGlobal | undefined;
+declare function getOrCreateQwikDevtoolsGlobal(pageWindow?: Window | undefined): QwikDevtoolsWindowGlobal;
+declare function getQwikDevtoolsComponentState(pageWindow?: Window | undefined | null): Record<string, ComponentDevtoolsState>;
+//#endregion
+//#region kit/src/overlay-paths.d.ts
+declare function normalizeExcludePathnames(pathnames: string[] | undefined): string[];
+declare function isExcludedPathname(pathname: string, excludePathnames: string[]): boolean;
+//#endregion
+//#region kit/src/protocol/capabilities.d.ts
+type DevtoolsCapabilityName = 'hooks' | 'perf' | 'vnode';
+interface VirtualModuleDefinition {
+  id: string;
+  load: () => string;
+}
+interface DevtoolsCapability {
+  name: DevtoolsCapabilityName;
+  virtualModules?: VirtualModuleDefinition[];
+}
+//#endregion
+//#region kit/src/protocol/dom.d.ts
+declare const QWIK_CONTAINER_SELECTOR = "[q\\:container]:not([q\\:container=\"html\"]):not([q\\:container=\"text\"])";
+declare const V2_BINDING_ATTR = ":";
+declare const QWIK_ATTR: {
+  readonly BASE: "q:base";
+  readonly CONTAINER: "q:container";
+  readonly ID: "q:id";
+  readonly KEY: "q:key";
+  readonly MANIFEST_HASH: "q:manifest-hash";
+  readonly RENDER: "q:render";
+  readonly RUNTIME: "q:instance";
+  readonly VERSION: "q:version";
+};
+//#endregion
+export { AssetInfo, AssetType, BuildAnalysisRunResult, BuildAnalysisStatus, CLIENT_CTX, CLIENT_RPC, Category, ClientFunctions, ClientRpc, Component, ComponentDevtoolsState, DEFAULT_PERF_STORE_EXPRESSION, DEVTOOLS_MESSAGES, DependenciesStatus, DependencyAuthor, DependencyInfo, DependencyOperationResult, DependencyType, DependencyVersionStatus, DevtoolsCapability, DevtoolsCapabilityName, DevtoolsComponentDetailEntry, DevtoolsRenderEvent, DevtoolsRenderStats, DevtoolsVNodeTreeNode, EXPRESSION_STATEMENT_LIST, HOOK_GROUPS, HookType, INNER_USE_HOOK, ImageMeta, InPageBridge, InPageBridgeOptions, InstallDependencyType, ModuleLookupResult, NORETURN_HOOK, NpmInfo, PERF_PHASE_CSR, PERF_PHASE_SSR, PERF_VIRTUAL_MODULE_ID, PackageInstallResult, PackageSearchResponse, PackageSearchResult, PageDataSource, ParsedQwikCodeResult, ParsedStructure, QWIK_ATTR, QWIK_CONTAINER_SELECTOR, QWIK_DEVTOOLS_GLOBAL, QWIK_DEVTOOLS_HOOK_VERSION, QWIK_VNODE_PROTOCOL, QwikDevtoolsComponentSnapshot, QwikDevtoolsHook, QwikDevtoolsHookExtended, QwikDevtoolsPageMessage, QwikDevtoolsPerfPhase, QwikDevtoolsRenderEvent, QwikDevtoolsSignalEntry, QwikDevtoolsSignalEvent, QwikDevtoolsSignalsSnapshot, QwikDevtoolsWindowGlobal, QwikPerfEntryRemembered, QwikPerfErrorRemembered, QwikPerfPhaseRemembered, QwikPerfStoreRemembered, QwikPreloadEntryRemembered, QwikPreloadLoadMatchQuality, QwikPreloadMatchMode, QwikPreloadOriginKind, QwikPreloadPhase, QwikPreloadQrlRequestRemembered, QwikPreloadSource, QwikPreloadStatus, QwikPreloadStoreRemembered, QwikSsrPreloadSnapshotRemembered, RouteType, RoutesInfo, SERVER_CTX, SERVER_RPC, SIGNAL_HOOK_TYPES, ServerFunctions, ServerRpc, ServerRpcRequestContext, USE_HOOK_LIST, V2_BINDING_ATTR, VARIABLE_DECLARATION_LIST, VIRTUAL_QWIK_DEVTOOLS_KEY, VirtualModuleDefinition, ViteClientContext, ViteServerContext, createClientRpc, createGlobalAccessor, createInPageBridge, createServerRpc, getOrCreateQwikDevtoolsGlobal, getQwikDevtoolsComponentState, getQwikDevtoolsGlobal, getServerRpcRequestContext, getViteClientContext, getViteClientRpc, getViteServerContext, getViteServerRpc, isExcludedPathname, normalizeExcludePathnames, setViteClientContext, setViteClientRpc, setViteServerContext, setViteServerRpc };