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

package/dist/kit/index.mjs

@@ -0,0 +1,323 @@
+import SuperJSON from "superjson";
+import { createBirpc } from "birpc";
+import { Type as RouteType } from "dree";
+//#region kit/src/protocol/messages.ts
+const DEVTOOLS_MESSAGES = {
+	pageSource: "qwik-devtools",
+	viteMessagingEvent: "qwik_tools:vite_messaging_event",
+	types: {
+		render: "RENDER_EVENT",
+		componentTreeUpdate: "COMPONENT_TREE_UPDATE"
+	},
+	events: {
+		preloadsUpdate: "qwik:preloads-update",
+		ssrPerf: "qwik:ssr-perf",
+		ssrPreloads: "qwik:ssr-preloads"
+	}
+};
+//#endregion
+//#region kit/src/protocol/hooks.ts
+const HOOK_GROUPS = {
+	variableDeclaration: [
+		"useStore",
+		"useSignal",
+		"useComputed",
+		"useAsyncComputed",
+		"useContext",
+		"useId",
+		"useStyles",
+		"useStylesScoped",
+		"useConstant",
+		"useErrorBoundary",
+		"useSerializer",
+		"useServerData",
+		"useLocation",
+		"useNavigate",
+		"useContent",
+		"useDocumentHead"
+	],
+	expressionStatement: [
+		"useVisibleTask",
+		"useTask",
+		"useResource",
+		"useContextProvider",
+		"usePreventNavigate"
+	],
+	listener: [
+		"useOn",
+		"useOnDocument",
+		"useOnWindow"
+	],
+	noReturn: ["useVisibleTask", "useTask"]
+};
+const VARIABLE_DECLARATION_LIST = HOOK_GROUPS.variableDeclaration;
+const EXPRESSION_STATEMENT_LIST = HOOK_GROUPS.expressionStatement;
+const USE_HOOK_LIST = [
+	...VARIABLE_DECLARATION_LIST,
+	...HOOK_GROUPS.listener,
+	...EXPRESSION_STATEMENT_LIST
+];
+const NORETURN_HOOK = HOOK_GROUPS.noReturn;
+const SIGNAL_HOOK_TYPES = [
+	"useSignal",
+	"useStore",
+	"useComputed",
+	"useAsyncComputed",
+	"useContext"
+];
+const INNER_USE_HOOK = "useCollectHooks";
+const VIRTUAL_QWIK_DEVTOOLS_KEY = "virtual-qwik-devtools.ts";
+const QWIK_DEVTOOLS_HOOK_VERSION = 1;
+//#endregion
+//#region kit/src/protocol/vnode.ts
+const QWIK_VNODE_PROTOCOL = {
+	attrs: {
+		seq: "q:seq",
+		props: "q:props",
+		renderFn: "q:renderFn",
+		type: "q:type",
+		id: "q:id",
+		key: "q:key",
+		colon: ":"
+	},
+	qrl: {
+		qrl: "$qrl$",
+		computed: "$computeQrl$",
+		chunk: "$chunk$",
+		symbol: "$symbol$",
+		captureRef: "$captureRef$",
+		untrackedValue: "$untrackedValue$"
+	},
+	bridgeVirtualModuleId: "virtual:qwik-devtools-bridge"
+};
+//#endregion
+//#region kit/src/protocol/globals.ts
+const QWIK_DEVTOOLS_GLOBAL = {
+	key: "__QWIK_DEVTOOLS__",
+	version: 1,
+	props: {
+		componentState: "componentState",
+		hook: "hook",
+		pageDataSource: "pageDataSource",
+		dataProvider: "dataProvider",
+		perf: "perf",
+		preloads: "preloads",
+		ssrPreloads: "ssrPreloads"
+	},
+	ssr: {
+		perfStore: "__QWIK_SSR_PERF__",
+		preloadsProcessStore: "__QWIK_SSR_PRELOADS__",
+		perfId: "__QWIK_SSR_PERF_ID__",
+		perfIndex: "__QWIK_SSR_PERF_INDEX__",
+		perfCount: "__QWIK_SSR_PERF_COUNT__"
+	}
+};
+//#endregion
+//#region kit/src/globals.ts
+const CLIENT_CTX = "__qwik_client_ctx__";
+const SERVER_CTX = "__qwik_server_ctx__";
+const SERVER_RPC = "__qwik_server_rpc__";
+const CLIENT_RPC = "__qwik_client_rpc__";
+//#endregion
+//#region kit/src/global-store.ts
+const globalStore = typeof window !== "undefined" ? window : typeof globalThis !== "undefined" ? globalThis : typeof global !== "undefined" ? global : {};
+function createGlobalAccessor(key) {
+	return {
+		get: () => globalStore[key],
+		set: (value) => {
+			globalStore[key] = value;
+		}
+	};
+}
+function getDefaultWindow() {
+	return typeof window === "undefined" ? void 0 : window;
+}
+function getQwikDevtoolsGlobal(pageWindow = getDefaultWindow()) {
+	return pageWindow ? pageWindow[QWIK_DEVTOOLS_GLOBAL.key] : void 0;
+}
+function getOrCreateQwikDevtoolsGlobal(pageWindow = getDefaultWindow()) {
+	if (!pageWindow) throw new Error("Qwik DevTools global is only available in the browser");
+	const record = pageWindow;
+	const root = record[QWIK_DEVTOOLS_GLOBAL.key] ?? (record[QWIK_DEVTOOLS_GLOBAL.key] = {
+		version: QWIK_DEVTOOLS_GLOBAL.version,
+		[QWIK_DEVTOOLS_GLOBAL.props.componentState]: {}
+	});
+	root.version = root.version || QWIK_DEVTOOLS_GLOBAL.version;
+	root[QWIK_DEVTOOLS_GLOBAL.props.componentState] ??= {};
+	return root;
+}
+function getQwikDevtoolsComponentState(pageWindow = getDefaultWindow()) {
+	return getQwikDevtoolsGlobal(pageWindow)?.[QWIK_DEVTOOLS_GLOBAL.props.componentState] ?? {};
+}
+//#endregion
+//#region kit/src/context.ts
+const clientContextAccessor = createGlobalAccessor(CLIENT_CTX);
+const serverContextAccessor = createGlobalAccessor(SERVER_CTX);
+const serverRpcAccessor = createGlobalAccessor(SERVER_RPC);
+const clientRpcAccessor = createGlobalAccessor(CLIENT_RPC);
+const getViteClientContext = clientContextAccessor.get;
+const setViteClientContext = clientContextAccessor.set;
+const getViteServerContext = serverContextAccessor.get;
+const setViteServerContext = serverContextAccessor.set;
+const getViteServerRpc = serverRpcAccessor.get;
+const setViteServerRpc = serverRpcAccessor.set;
+const getViteClientRpc = clientRpcAccessor.get;
+const setViteClientRpc = clientRpcAccessor.set;
+//#endregion
+//#region kit/src/rpc-core.ts
+const RPC_TIMEOUT = 12e4;
+function parseRpcPayload(payload) {
+	return SuperJSON.parse(String(payload));
+}
+function createSerializedRpc(functions, channel) {
+	return createBirpc(functions, {
+		post: (data) => channel.post(SuperJSON.stringify(data)),
+		on: (handler) => channel.on((data) => handler(parseRpcPayload(data))),
+		timeout: RPC_TIMEOUT
+	});
+}
+//#endregion
+//#region kit/src/client.ts
+function createClientRpc(functions) {
+	const client = getViteClientContext();
+	const rpc = createSerializedRpc(functions, {
+		post: (data) => client.send(DEVTOOLS_MESSAGES.viteMessagingEvent, data),
+		on: (handler) => client.on(DEVTOOLS_MESSAGES.viteMessagingEvent, (data) => {
+			handler(data);
+		})
+	});
+	setViteClientRpc(rpc);
+}
+//#endregion
+//#region kit/src/client-bridge.ts
+function getPageWindow(isBrowser) {
+	if (!isBrowser || typeof window === "undefined") return null;
+	return window;
+}
+function getHook(pageWindow) {
+	return getQwikDevtoolsGlobal(pageWindow)?.[QWIK_DEVTOOLS_GLOBAL.props.hook];
+}
+function createInPageBridge(options) {
+	const getWindow = () => getPageWindow(options.isBrowser);
+	return {
+		async readPerfData() {
+			return getQwikDevtoolsGlobal(getWindow())?.[QWIK_DEVTOOLS_GLOBAL.props.perf] ?? null;
+		},
+		async readPreloadStore() {
+			return getQwikDevtoolsGlobal(getWindow())?.[QWIK_DEVTOOLS_GLOBAL.props.preloads] ?? null;
+		},
+		async clearPreloadStore() {
+			getQwikDevtoolsGlobal(getWindow())?.[QWIK_DEVTOOLS_GLOBAL.props.preloads]?.clear();
+		},
+		subscribePreloadUpdates(cb) {
+			const pageWindow = getWindow();
+			if (!pageWindow) return null;
+			pageWindow.addEventListener(DEVTOOLS_MESSAGES.events.preloadsUpdate, cb);
+			return () => pageWindow.removeEventListener(DEVTOOLS_MESSAGES.events.preloadsUpdate, cb);
+		},
+		async readComponentTree() {
+			return getHook(getWindow())?.getComponentTreeSnapshot() ?? null;
+		},
+		async readSignals() {
+			return getHook(getWindow())?.getSignalsSnapshot() ?? null;
+		},
+		async readVNodeTree() {
+			return getHook(getWindow())?.getVNodeTree?.() ?? null;
+		},
+		subscribeTreeUpdates(cb) {
+			const pageWindow = getWindow();
+			if (!pageWindow) return null;
+			const handler = (event) => {
+				const message = event.data;
+				if (message?.source === DEVTOOLS_MESSAGES.pageSource && message.type === DEVTOOLS_MESSAGES.types.componentTreeUpdate && Array.isArray(message.tree)) cb(message.tree);
+			};
+			pageWindow.addEventListener("message", handler);
+			return () => pageWindow.removeEventListener("message", handler);
+		},
+		async readComponentDetail(componentName, qrlChunk) {
+			return getHook(getWindow())?.getComponentDetail?.(componentName, qrlChunk) ?? null;
+		},
+		async readNodeProps(nodeId) {
+			return getHook(getWindow())?.getNodeProps?.(nodeId) ?? null;
+		},
+		async setSignalValue(componentName, qrlChunk, variableName, newValue) {
+			return getHook(getWindow())?.setSignalValue?.(componentName, qrlChunk, variableName, newValue) ?? false;
+		},
+		subscribeRenderEvents(cb) {
+			const pageWindow = getWindow();
+			if (!pageWindow) return null;
+			const handler = (event) => {
+				const message = event.data;
+				if (message?.source === DEVTOOLS_MESSAGES.pageSource && message.type === DEVTOOLS_MESSAGES.types.render && message.event) cb(message.event);
+			};
+			pageWindow.addEventListener("message", handler);
+			return () => pageWindow.removeEventListener("message", handler);
+		}
+	};
+}
+//#endregion
+//#region kit/src/server.ts
+let currentServerRpcRequestContext;
+function getServerRpcRequestContext() {
+	return currentServerRpcRequestContext;
+}
+function runWithServerRpcRequestContext(context, fn) {
+	const previous = currentServerRpcRequestContext;
+	currentServerRpcRequestContext = context;
+	try {
+		fn();
+	} finally {
+		currentServerRpcRequestContext = previous;
+	}
+}
+function createServerRpc(functions) {
+	const server = getViteServerContext();
+	const rpc = createSerializedRpc(functions, {
+		post: (data) => server.ws.send(DEVTOOLS_MESSAGES.viteMessagingEvent, data),
+		on: (handler) => server.ws.on(DEVTOOLS_MESSAGES.viteMessagingEvent, (data, client) => {
+			runWithServerRpcRequestContext({ client }, () => {
+				handler(data);
+			});
+		})
+	});
+	setViteServerRpc(rpc);
+}
+//#endregion
+//#region kit/src/overlay-paths.ts
+function normalizeExcludePathnames(pathnames) {
+	if (!pathnames) return [];
+	return [...new Set(pathnames.map(normalizeExcludePathname).filter(Boolean))];
+}
+function normalizeExcludePathname(pathname) {
+	const trimmed = pathname.trim();
+	if (!trimmed) return "";
+	const prefixed = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+	return prefixed.length > 1 ? prefixed.replace(/\/+$/, "") : prefixed;
+}
+function isExcludedPathname(pathname, excludePathnames) {
+	return normalizeExcludePathnames(excludePathnames).some((excludedPathname) => {
+		return pathname === excludedPathname || pathname.startsWith(excludedPathname + "/");
+	});
+}
+//#endregion
+//#region kit/src/protocol/perf.ts
+const PERF_VIRTUAL_MODULE_ID = "virtual:qwik-component-proxy";
+const PERF_PHASE_SSR = "ssr";
+const PERF_PHASE_CSR = "csr";
+const DEFAULT_PERF_STORE_EXPRESSION = "{ ssr: [], csr: [] }";
+//#endregion
+//#region kit/src/protocol/dom.ts
+const QWIK_CONTAINER_SELECTOR = "[q\\:container]:not([q\\:container=\"html\"]):not([q\\:container=\"text\"])";
+const V2_BINDING_ATTR = ":";
+const QWIK_ATTR = {
+	BASE: "q:base",
+	CONTAINER: "q:container",
+	ID: "q:id",
+	KEY: "q:key",
+	MANIFEST_HASH: "q:manifest-hash",
+	RENDER: "q:render",
+	RUNTIME: "q:instance",
+	VERSION: "q:version"
+};
+//#endregion
+export { CLIENT_CTX, CLIENT_RPC, DEFAULT_PERF_STORE_EXPRESSION, DEVTOOLS_MESSAGES, EXPRESSION_STATEMENT_LIST, HOOK_GROUPS, INNER_USE_HOOK, NORETURN_HOOK, PERF_PHASE_CSR, PERF_PHASE_SSR, PERF_VIRTUAL_MODULE_ID, QWIK_ATTR, QWIK_CONTAINER_SELECTOR, QWIK_DEVTOOLS_GLOBAL, QWIK_DEVTOOLS_HOOK_VERSION, QWIK_VNODE_PROTOCOL, RouteType, SERVER_CTX, SERVER_RPC, SIGNAL_HOOK_TYPES, USE_HOOK_LIST, V2_BINDING_ATTR, VARIABLE_DECLARATION_LIST, VIRTUAL_QWIK_DEVTOOLS_KEY, createClientRpc, createGlobalAccessor, createInPageBridge, createServerRpc, getOrCreateQwikDevtoolsGlobal, getQwikDevtoolsComponentState, getQwikDevtoolsGlobal, getServerRpcRequestContext, getViteClientContext, getViteClientRpc, getViteServerContext, getViteServerRpc, isExcludedPathname, normalizeExcludePathnames, setViteClientContext, setViteClientRpc, setViteServerContext, setViteServerRpc };

package/dist/plugin/codegen.d.mts

@@ -0,0 +1,13 @@
+//#region src/runtime/create-hook-runtime.d.ts
+declare function createHookRuntime(): string;
+/**
+ * Builds the plain-script (IIFE) form of the hook runtime for the browser extension's
+ * content-script injection. Reuses the exact same canonical installer as the Vite plugin so both
+ * code paths stay byte-for-byte in sync.
+ */
+declare function createExtensionHookRuntime(): string;
+//#endregion
+//#region src/runtime/create-vnode-runtime.d.ts
+declare function createVNodeRuntime(): string;
+//#endregion
+export { createExtensionHookRuntime, createHookRuntime, createVNodeRuntime };

package/dist/plugin/codegen.mjs

@@ -0,0 +1,2 @@
+import { n as createHookRuntime, r as createVNodeRuntime, t as createExtensionHookRuntime } from "./create-hook-runtime-ChnIePeB.mjs";
+export { createExtensionHookRuntime, createHookRuntime, createVNodeRuntime };