@ogygia/devtools 0.12.0 → 0.13.0

package/dist/devtools/session.js

@@ -1,4 +1,5 @@
 import { all_regions, region_name } from "./regions.js";
+import { STALE, flights, machine } from "@ogygia/machine";
 import { add_sink, snapshot } from "@ogygia/core/events";
 // src/devtools/session.ts
 /**
@@ -126,6 +127,17 @@ function describe_el(el) {
 	const text = (el.textContent ?? "").trim().slice(0, 24);
 	return text ? `${s} "${text}${(el.textContent ?? "").trim().length > 24 ? "…" : ""}"` : s;
 }
+/** One recording's run. Leaving `recording`, whichever way, takes its watchers off, once. */
+const run_definition = machine()({
+	name: "session-recorder",
+	initial: "recording",
+	steps: {
+		recording: ["saved", "stopped"],
+		saved: [],
+		stopped: []
+	}
+});
+/** The recording now: the newest started and not yet stopped. */
 let active = null;
 /** the last finished session (its data + report), for every tab: the Record tab writes it, the
 *  island detail reads its island's part (the report type lives in session-insights.ts) */
@@ -147,6 +159,8 @@ function recording() {
 /** Start recording (or go on with the parts earlier pages saved — `resume_session_if_any`). */
 function start_session(prior) {
 	if (active) return active;
+	const run = run_definition.create();
+	const s = run.scope;
 	const from = performance.now();
 	const seq0 = snapshot().at(-1)?.seq ?? -1;
 	const interactions = [];
@@ -160,20 +174,21 @@ function start_session(prior) {
 		for (const r of all_regions()) if (r.fp && !names[r.fp]) names[r.fp] = region_name(r.entry);
 	};
 	note_names();
-	const off_nav = add_sink((e) => {
+	s.defer(add_sink((e) => {
 		if (e.name === "nav.start") note_names();
-	});
-	const observers = [];
+	}));
 	const watch = (type, cb, extra = {}) => {
 		try {
-			const po = new PerformanceObserver((l) => cb(l.getEntries()));
+			const po = s.watch(new PerformanceObserver((l) => cb(l.getEntries())));
 			po.observe({
 				type,
 				...extra
 			});
-			observers.push({
-				po,
-				cb
+			s.defer(() => {
+				try {
+					const left = po.takeRecords();
+					if (left.length) cb(left);
+				} catch {}
 			});
 		} catch {}
 	};
@@ -234,7 +249,7 @@ function start_session(prior) {
 		}
 	});
 	const mut_log = [];
-	const mo = new MutationObserver((records) => {
+	const mo = s.watch(new MutationObserver((records) => {
 		const now = r1(performance.now());
 		const seen = /* @__PURE__ */ new Set();
 		for (const m of records) {
@@ -249,7 +264,7 @@ function start_session(prior) {
 				});
 			}
 		}
-	});
+	}));
 	const clicks = [];
 	const on_click = (e) => {
 		if (clicks.length >= 2e3) return;
@@ -263,7 +278,7 @@ function start_session(prior) {
 			...el && looks_clickable(el) ? { clickable: true } : {}
 		});
 	};
-	addEventListener("click", on_click, {
+	s.on(globalThis, "click", on_click, {
 		capture: true,
 		passive: true
 	});
@@ -278,13 +293,12 @@ function start_session(prior) {
 			until: performance.now() + 50
 		};
 	};
-	const INPUTS = [
+	for (const type of [
 		"click",
 		"submit",
 		"keydown",
 		"change"
-	];
-	for (const type of INPUTS) addEventListener(type, on_input, {
+	]) s.on(globalThis, type, on_input, {
 		capture: true,
 		passive: true
 	});
@@ -303,7 +317,7 @@ function start_session(prior) {
 			fp: by ? island_of(by)?.getAttribute("data-og-fp") ?? null : input?.fp ?? null
 		});
 	};
-	navigation?.addEventListener("navigate", on_navigate);
+	if (navigation) s.on(navigation, "navigate", on_navigate);
 	const requests = [];
 	watch("resource", (es) => {
 		for (const r of es) {
@@ -340,9 +354,10 @@ function start_session(prior) {
 		t: r1(performance.now()),
 		message: "unhandled rejection: " + String(e.reason?.message ?? e.reason).slice(0, 280)
 	});
-	addEventListener("error", on_error);
-	addEventListener("unhandledrejection", on_rej);
+	s.on(globalThis, "error", on_error);
+	s.on(globalThis, "unhandledrejection", on_rej);
 	const console_error = console.error;
+	s.defer(() => console.error = console_error);
 	console.error = (...args) => {
 		if (errors.length < 200) errors.push({
 			t: r1(performance.now()),
@@ -363,23 +378,6 @@ function start_session(prior) {
 		cpu_off = "no-policy";
 	}
 	const heap0 = performance.memory?.usedJSHeapSize ?? null;
-	/** stop watching (the entries still queued count too) */
-	const detach = () => {
-		for (const { po, cb } of observers) try {
-			const left = po.takeRecords();
-			if (left.length) cb(left);
-			po.disconnect();
-		} catch {}
-		mo.disconnect();
-		off_nav();
-		removeEventListener("error", on_error);
-		removeEventListener("unhandledrejection", on_rej);
-		removeEventListener("click", on_click, { capture: true });
-		for (const type of INPUTS) removeEventListener(type, on_input, { capture: true });
-		navigation?.removeEventListener("navigate", on_navigate);
-		removeEventListener("pagehide", on_hide);
-		console.error = console_error;
-	};
 	/** this document's part of the session */
 	const collect = (cpu) => {
 		const heap1 = performance.memory?.usedJSHeapSize ?? null;
@@ -416,9 +414,7 @@ function start_session(prior) {
 		};
 	};
 	const on_hide = (e) => {
-		if (e.persisted || active !== rec) return;
-		detach();
-		active = null;
+		if (e.persisted || !run.move("recording", "saved")) return;
 		const strip = (s) => JSON.parse(JSON.stringify({
 			...s,
 			cpu: null
@@ -430,12 +426,14 @@ function start_session(prior) {
 			}]));
 		} catch {}
 	};
-	addEventListener("pagehide", on_hide);
-	const rec = {
-		started: prior?.length ? prior[0].data.from + (prior[0].origin - performance.timeOrigin) : from,
-		async stop() {
-			active = null;
-			detach();
+	s.on(globalThis, "pagehide", on_hide);
+	s.defer(() => {
+		if (active === rec) active = null;
+	});
+	const stopping = flights({
+		name: "session stop",
+		run: async () => {
+			run.move("recording", "stopped");
 			let cpu = null;
 			if (prof) try {
 				cpu = await prof.stop();
@@ -448,6 +446,14 @@ function start_session(prior) {
 			} catch {}
 			return prior?.length ? merge_parts(prior, here) : here;
 		}
+	});
+	const stop = async () => {
+		const data = await stopping.get();
+		return data === STALE ? stop() : data;
+	};
+	const rec = {
+		started: prior?.length ? prior[0].data.from + (prior[0].origin - performance.timeOrigin) : from,
+		stop
 	};
 	active = rec;
 	return rec;

package/dist/devtools/testing-engine.js

@@ -5,6 +5,7 @@ import { region_name_by_fp } from "./regions.js";
 import { ensure_region_names } from "./names.js";
 import { TESTING_ENGINE_VERSION, analyze_session, apply_attr_rules, session_timeline, testing_lean } from "@ogygia/core/insights";
 import { charge, nearest_attr, own_cost } from "@ogygia/core/internal/instruments";
+import { scope } from "@ogygia/machine";
 import { snapshot } from "@ogygia/core/events";
 // src/devtools/testing-engine.ts
 /**
@@ -202,6 +203,14 @@ async function record_stop(blocked = []) {
 /** Resolves when no island is mid-hydration and nothing woke for `quiet` ms (or `timeout` passed). */
 async function settled(quiet = 300, timeout = 1e4) {
 	const until = performance.now() + timeout;
+	const steps = scope();
+	try {
+		return await settle_poll(steps, quiet, until);
+	} finally {
+		steps.close();
+	}
+}
+async function settle_poll(steps, quiet, until) {
 	for (;;) {
 		const ev = snapshot();
 		const started = /* @__PURE__ */ new Set();
@@ -214,7 +223,7 @@ async function settled(quiet = 300, timeout = 1e4) {
 		}
 		if (!started.size && performance.now() - last >= quiet && document.readyState === "complete") return true;
 		if (performance.now() > until) return false;
-		await new Promise((r) => setTimeout(r, 50));
+		await steps.task(() => new Promise((r) => steps.timeout(r, 50)));
 	}
 }
 export { hydration_json, note_engine_files, page_json, record_start, record_stop, settled };

package/dist/devtools/ui-app.d.ts

@@ -1,5 +1,7 @@
+/** Mounts the dock into `root`. Returns its teardown: the app (its Alt+O listener and timers with
+ *  it) unmounted and its observers off. */
 export declare function mount_app(root: ShadowRoot, opts: {
   csr_true: boolean;
   start_open: boolean;
   hide?: () => void;
-}): void;
+}): () => void;

package/dist/devtools/ui-app.js

@@ -1,7 +1,8 @@
 import { install_page_hook } from "./page.js";
 import { set_highlight_root } from "./highlight.js";
+import { scope } from "@ogygia/machine";
 import { names } from "virtual:ogygia/devtools-meta";
-import { mount } from "svelte";
+import { mount, unmount } from "svelte";
 import Devtools from "./Devtools.svelte";
 // src/devtools/ui-app.ts
 /**
@@ -10,6 +11,8 @@ import Devtools from "./Devtools.svelte";
 * only the launcher in the runtime chunk: this file, the components and their CSS load when someone
 * opens the dock (a dynamic import the bundler splits off). On the dev server it loads at once.
 */
+/** Mounts the dock into `root`. Returns its teardown: the app (its Alt+O listener and timers with
+*  it) unmounted and its observers off. */
 function mount_app(root, opts) {
 	install_page_hook();
 	set_highlight_root(root);
@@ -17,7 +20,7 @@ function mount_app(root, opts) {
 		...names,
 		...window.__ogygia_region_names
 	};
-	mount(Devtools, {
+	const app = mount(Devtools, {
 		target: root,
 		props: {
 			csrTrue: opts.csr_true,
@@ -26,12 +29,15 @@ function mount_app(root, opts) {
 		}
 	});
 	adopt_scoped_styles(root);
-	const mo = new MutationObserver(() => adopt_scoped_styles(root));
+	const s = scope();
+	s.defer(() => void unmount(app));
+	const mo = s.watch(new MutationObserver(() => adopt_scoped_styles(root)));
 	mo.observe(document.head, { childList: true });
 	mo.observe(root, {
 		childList: true,
 		subtree: true
 	});
+	return () => s.close();
 }
 /** the dock's `<style>`s a page's Content-Security-Policy refused, already re-made as sheets */
 const remade = /* @__PURE__ */ new WeakSet();

package/dist/devtools/ui.js

@@ -1,4 +1,7 @@
+import { OgygiaError } from "../messages/runtime.js";
 import { TESTING_ENGINE_VERSION, devtools_switched_on, switch_in_url, testing_lean, without_switch, write_switch } from "@ogygia/core/insights";
+import { import_again } from "@ogygia/core/internal/instruments";
+import { STALE, flights, machine } from "@ogygia/machine";
 // src/devtools/ui.ts
 /**
 * The devtools LAUNCHER — the only part of devtools the runtime chunk carries. Called from the runtime
@@ -17,13 +20,30 @@ import { TESTING_ENGINE_VERSION, devtools_switched_on, switch_in_url, testing_le
 * The switch's cookie also starts the rest, for that browser only: the server writes its event
 * side-channel and the page is measured from the start (runtime/beacon.ts).
 */
+/** The dock's code: after a failed download, asked for again under a fresh URL. */
+const import_app = import_again(() => import("./ui-app.js"));
 const DEVTOOLS = typeof __OGYGIA_DEVTOOLS__ !== "undefined" ? __OGYGIA_DEVTOOLS__ : false;
 const LAZY = typeof __OGYGIA_DEVTOOLS_LAZY__ !== "undefined" ? __OGYGIA_DEVTOOLS_LAZY__ : false;
 const LAYOUT_KEY = "ogygia:devtools:layout:v4";
-let mounted = false;
+const dock_definition = machine()({
+	name: "devtools-dock",
+	initial: "button",
+	steps: {
+		button: ["loading", "off"],
+		loading: [
+			"button",
+			"mounted",
+			"off"
+		],
+		mounted: ["off"],
+		off: []
+	}
+});
+/** This module's dock, until devtools is turned off. */
+let dock = null;
 let launch_opts;
 function install_devtools_ui(opts) {
-	if (!DEVTOOLS || typeof document === "undefined" || mounted) return;
+	if (!DEVTOOLS || typeof document === "undefined" || dock) return;
 	if (document.querySelector("meta[name=\"ogygia-devtools\"][content=\"off\"]")) return;
 	launch_opts = opts;
 	install_testing_api();
@@ -37,10 +57,9 @@ function install_devtools_ui(opts) {
 }
 /** The launcher (and, on the dev server or for a dock left open, the dock). */
 function mount_launcher(opts) {
-	if (mounted || document.querySelector("[data-ogygia-devtools-host]")) return;
-	mounted = true;
+	if (dock || document.querySelector("[data-ogygia-devtools-host]")) return;
 	try {
-		if (sessionStorage.getItem("ogygia:devtools:session")) import("./session.js").then((m) => m.resume_session_if_any());
+		if (sessionStorage.getItem("ogygia:devtools:session")) import("./session.js").then((m) => m.resume_session_if_any(), (error) => console.error(new OgygiaError("devtools_dock_load_failed"), error));
 	} catch {}
 	const host = document.createElement("div");
 	host.setAttribute("data-ogygia-devtools-host", "");
@@ -48,66 +67,85 @@ function mount_launcher(opts) {
 	document.documentElement.appendChild(host);
 	const root = host.attachShadow({ mode: "open" });
 	const csr_true = opts?.csr_true ?? false;
-	let loading = false;
+	const here = {
+		machine: dock_definition.create(),
+		host,
+		launcher: new AbortController()
+	};
+	dock = here;
+	const state = here.machine;
 	let want_open = false;
-	let button = null;
-	let on_key = null;
+	const button = document.createElement("button");
 	const load = () => {
-		if (loading) return;
-		loading = true;
-		import("./ui-app.js").then((m) => {
-			button?.remove();
-			if (on_key) removeEventListener("keydown", on_key);
-			m.mount_app(root, {
+		if (!state.move("button", "loading")) return;
+		state.scope.task(() => import_app()).then((app) => {
+			if (app === STALE || !state.move("loading", "mounted")) return;
+			here.launcher.abort();
+			button.remove();
+			state.scope.defer(app.mount_app(root, {
 				csr_true,
 				start_open: want_open,
 				...LAZY ? { hide: devtools_off } : {}
-			});
+			}));
+		}, (error) => {
+			if (!state.move("loading", "button")) return;
+			want_open = false;
+			button.textContent = "og devtools";
+			console.error(new OgygiaError("devtools_dock_load_failed"), error);
 		});
 	};
-	button = document.createElement("button");
 	button.setAttribute("data-og-panel-toggle", "");
 	button.title = "ogygia devtools (Alt+O)";
 	button.textContent = "og devtools";
 	button.style.cssText = "position:fixed;right:24px;bottom:8px;padding:7px 12px;border-radius:999px;border:1px solid rgba(148,163,184,.35);background:#0b1220;color:#e2e8f0;font:600 12px/1 ui-monospace,SFMono-Regular,Menlo,monospace;cursor:pointer;opacity:.55;box-shadow:0 4px 16px rgba(0,0,0,.4)";
-	const b = button;
-	b.onmouseenter = () => b.style.opacity = "1";
-	b.onmouseleave = () => b.style.opacity = ".55";
+	button.onmouseenter = () => button.style.opacity = "1";
+	button.onmouseleave = () => button.style.opacity = ".55";
 	const open = () => {
 		want_open = true;
-		b.textContent = "loading…";
+		button.textContent = "loading…";
 		load();
 	};
-	b.onclick = open;
-	on_key = (e) => {
+	button.onclick = open;
+	addEventListener("keydown", (e) => {
 		if (e.altKey && (e.key === "o" || e.key === "O")) {
 			e.preventDefault();
 			open();
 		}
-	};
-	addEventListener("keydown", on_key);
-	root.appendChild(b);
+	}, { signal: here.launcher.signal });
+	root.appendChild(button);
 	if (was_open()) load();
-	else if (!LAZY) after_load_idle(load);
+	else if (!LAZY) after_load_idle(state.scope, load);
 }
-function after_load_idle(fn) {
+/** Runs `fn` once the page is loaded and the browser idle, unless `s` closes first. */
+function after_load_idle(s, fn) {
 	const idle = () => {
-		const ric = globalThis.requestIdleCallback;
-		if (ric) ric(fn, { timeout: 3e3 });
-		else setTimeout(fn, 1e3);
+		const host = globalThis;
+		if (!host.requestIdleCallback) {
+			s.timeout(fn, 1e3);
+			return;
+		}
+		const id = host.requestIdleCallback(fn, { timeout: 3e3 });
+		s.defer(() => host.cancelIdleCallback?.(id));
 	};
-	if (document.readyState === "complete") setTimeout(idle, 500);
-	else addEventListener("load", () => setTimeout(idle, 500), { once: true });
+	if (document.readyState === "complete") s.timeout(idle, 500);
+	else s.on(globalThis, "load", () => s.timeout(idle, 500), { once: true });
 }
 function install_testing_api() {
 	if (window.__ogygia_testing) return;
-	let loading = null;
-	const engine = () => loading ??= (async () => {
-		const from = performance.now();
-		const m = await import("./testing-engine.js");
-		m.note_engine_files(from, performance.now());
-		return m;
-	})();
+	const import_engine = import_again(() => import("./testing-engine.js"));
+	const load_engine = flights({
+		name: "testing engine",
+		run: async () => {
+			const from = performance.now();
+			const m = await import_engine();
+			m.note_engine_files(from, performance.now());
+			return m;
+		}
+	});
+	const engine = async () => {
+		const m = await load_engine.get();
+		return m === STALE ? engine() : m;
+	};
 	window.__ogygia_testing = {
 		version: TESTING_ENGINE_VERSION,
 		page: async (cpu_fns) => (await engine()).page_json(cpu_fns),
@@ -142,8 +180,13 @@ function devtools_off() {
 	try {
 		localStorage.removeItem(LAYOUT_KEY);
 	} catch {}
+	if (dock) {
+		dock.machine.go("off");
+		dock.launcher.abort();
+		dock.host.remove();
+		dock = null;
+	}
 	document.querySelector("[data-ogygia-devtools-host]")?.remove();
-	mounted = false;
 }
 function install_console_api() {
 	const say = (on) => on ? "ogygia devtools: on in this browser (stays on; ogygia.devtools.off() to hide it)" : "ogygia devtools: off in this browser";

package/dist/messages/build.d.ts

@@ -0,0 +1,21 @@
+import { MessagesOf } from "@ogygia/core/internal/messages";
+/** The errors: `throw new OgygiaError(code, args)`. */
+export declare const DEVTOOLS_BUILD_ERRORS: {};
+/** The warnings: `warn(code, args, ...rest)`. */
+export declare const DEVTOOLS_BUILD_WARNINGS: {
+  devtools_on_in_build: {
+    text: () => string;
+    details: () => string;
+  };
+  devtools_profiler_secret_empty: {
+    text: () => string;
+    details: () => string;
+  };
+};
+type Own = MessagesOf<typeof DEVTOOLS_BUILD_ERRORS, typeof DEVTOOLS_BUILD_WARNINGS>;
+/** `throw new OgygiaError(code, args)`; `warn(code, args, ...rest)` logs; `line(code, args)` is the
+ *  line as a string. */
+export declare const OgygiaError: Own["OgygiaError"];
+export declare const warn: Own["warn"];
+export declare const line: Own["line"];
+export {};

package/dist/messages/build.js

@@ -0,0 +1,56 @@
+import { define_messages, prose } from "@ogygia/core/internal/messages";
+// src/messages/build.ts
+/**
+* EVERY MESSAGE THE DEVTOOLS' VITE PLUGIN PRINTS, in one place: its code, its wording, what to do
+* about it (core's `@ogygia/core/internal/messages` says how the system works).
+*
+*   warn('devtools_on_in_build');
+*
+* The plugin runs in Node, never in a page, so the wording always prints, then the code's page. The
+* profiler's server half has its own (./runtime.ts).
+*/
+/** The errors: `throw new OgygiaError(code, args)`. */
+const DEVTOOLS_BUILD_ERRORS = {};
+/** The warnings: `warn(code, args, ...rest)`. */
+const DEVTOOLS_BUILD_WARNINGS = {
+	devtools_on_in_build: {
+		text: () => prose`
+			devtools is ON for this build: its pages carry the devtools launcher (the dock loads only
+			when opened). Keep it off for production: list \`devtools()\` only when
+			\`mode !== 'production'\`.
+		`,
+		details: () => prose`
+			A build ran with the devtools dock on, so every page it serves carries the devtools
+			launcher. The dock itself loads only when someone opens it. Said once per build, so a
+			dock left on by accident is seen before it ships.
+
+			To keep it out of production, list \`devtools()\` only when
+			\`mode !== 'production'\`.
+		`
+	},
+	devtools_profiler_secret_empty: {
+		text: () => prose`
+			profiler: \`profiler.secret\` is EMPTY in this build — the variable it reads is not set in
+			the BUILD environment. The UI will be DISABLED in production unless OGYGIA_PROFILER_SECRET
+			exists at runtime (on Amplify / Lambda it does not): /__profiler will answer "installed but
+			disabled". Set the variable where the build runs, and keep the \`profiler\` option
+			unconditional.
+		`,
+		details: () => prose`
+			The profiler was given a \`secret\`, but it is empty while the app builds: the environment
+			variable it reads is not set where the build runs. The secret is baked in at build time,
+			so the profiler's UI stays disabled in production unless \`OGYGIA_PROFILER_SECRET\` is
+			set on the running server, which some hosts never do.
+
+			Set the variable in the build environment, and keep the \`profiler\` option
+			unconditional.
+		`
+	}
+};
+const own = define_messages(DEVTOOLS_BUILD_ERRORS, DEVTOOLS_BUILD_WARNINGS);
+/** `throw new OgygiaError(code, args)`; `warn(code, args, ...rest)` logs; `line(code, args)` is the
+*  line as a string. */
+const OgygiaError = own.OgygiaError;
+const warn = own.warn;
+const line = own.line;
+export { DEVTOOLS_BUILD_ERRORS, DEVTOOLS_BUILD_WARNINGS, OgygiaError, line, warn };

package/dist/messages/index.d.ts

@@ -0,0 +1,3 @@
+import { DEVTOOLS_BUILD_ERRORS, DEVTOOLS_BUILD_WARNINGS } from "./build.js";
+import { DEVTOOLS_ERRORS, DEVTOOLS_WARNINGS } from "./runtime.js";
+export { DEVTOOLS_BUILD_ERRORS, DEVTOOLS_BUILD_WARNINGS, DEVTOOLS_ERRORS, DEVTOOLS_WARNINGS };

package/dist/messages/index.js

@@ -0,0 +1,3 @@
+import { DEVTOOLS_BUILD_ERRORS, DEVTOOLS_BUILD_WARNINGS } from "./build.js";
+import { DEVTOOLS_ERRORS, DEVTOOLS_WARNINGS } from "./runtime.js";
+export { DEVTOOLS_BUILD_ERRORS, DEVTOOLS_BUILD_WARNINGS, DEVTOOLS_ERRORS, DEVTOOLS_WARNINGS };

package/dist/messages/runtime.d.ts

@@ -0,0 +1,63 @@
+import { MessagesOf } from "@ogygia/core/internal/messages";
+/** The errors: `throw new OgygiaError(code, args)`, or `console.error(new OgygiaError(…), err)` for a
+ *  failure that is caught. */
+export declare const DEVTOOLS_ERRORS: {
+  devtools_profiler_store_init_failed: {
+    text: () => string;
+    details: () => string;
+  };
+  devtools_profiler_mount_failed: {
+    text: () => string;
+    details: () => string;
+  };
+  devtools_profiler_alloc_sampling_unavailable: {
+    text: () => string;
+    details: () => string;
+  };
+  devtools_profiler_gc_attribution_failed: {
+    text: () => string;
+    details: () => string;
+  };
+  devtools_profiler_put_report_failed: {
+    text: () => string;
+    details: () => string;
+  };
+  devtools_profiler_get_report_failed: {
+    text: () => string;
+    details: () => string;
+  };
+  devtools_dock_load_failed: {
+    text: () => string;
+    details: () => string;
+  };
+};
+/** The warnings: `warn(code, args, ...rest)`. */
+export declare const DEVTOOLS_WARNINGS: {
+  devtools_profiler_session_rejected: {
+    text: (a: {
+      path: string;
+      diagnosis: string;
+      reason: string;
+    }) => string;
+    details: () => string;
+  };
+  devtools_profiler_sink_undelivered: {
+    text: (a: {
+      rows: string;
+    }) => string;
+    details: () => string;
+  };
+  devtools_profiler_background_stopped: {
+    text: (a: {
+      loop: string;
+    }) => string;
+    details: () => string;
+  };
+};
+type Own = MessagesOf<typeof DEVTOOLS_ERRORS, typeof DEVTOOLS_WARNINGS>;
+/** `throw new OgygiaError(code, args)`; `warn(code, args, ...rest)` logs; `line(code, args)` is the
+ *  line as a string. Wording and link in dev and while prerendering, the link alone otherwise. */
+export declare const OgygiaError: Own["OgygiaError"];
+export declare const warn: Own["warn"];
+export declare const line: Own["line"];
+export {};