@ossido-labs/ossido-ui 0.1.0

package/dist/esm/components/devErrorSource.js

@@ -0,0 +1,321 @@
+//#region src/components/devErrorSource.ts
+const SOURCE_CONTEXT = 5;
+/** Map a source file extension to the Shiki grammar (language) to load. */
+function langForFile(file) {
+	switch (extensionOf(file)) {
+		case ".tsx":
+		case ".jsx": return "tsx";
+		case ".ts": return "typescript";
+		case ".rs": return "rust";
+		default: return "javascript";
+	}
+}
+const V8_LINE = /^(?:(.*?)\s+)?\(?([^()]+):(\d+):(\d+)\)?$/;
+const SPIDERMONKEY_LINE = /^(.*?)@(.+):(\d+):(\d+)$/;
+const RUST_FRAME = /^\d+:\s+(.+)$/;
+function parseStack(stack) {
+	if (!stack) return [];
+	const frames = [];
+	let pendingFn;
+	const flushPending = () => {
+		if (pendingFn !== void 0) {
+			frames.push({ fn: pendingFn });
+			pendingFn = void 0;
+		}
+	};
+	for (const rawLine of stack.split("\n")) {
+		const line = rawLine.trim();
+		if (!line) continue;
+		const rustFrame = line.match(RUST_FRAME);
+		if (rustFrame) {
+			flushPending();
+			pendingFn = rustFrame[1];
+			continue;
+		}
+		if (line.startsWith("at ")) {
+			const match = line.slice(3).trim().match(V8_LINE);
+			if (match) frames.push({
+				fn: pendingFn ?? (match[1]?.trim() || void 0),
+				file: match[2],
+				line: Number(match[3]),
+				column: Number(match[4])
+			});
+			else frames.push({ fn: pendingFn ?? line.slice(3).trim() });
+			pendingFn = void 0;
+			continue;
+		}
+		const match = line.match(SPIDERMONKEY_LINE);
+		if (match) {
+			flushPending();
+			frames.push({
+				fn: match[1] || void 0,
+				file: match[2],
+				line: Number(match[3]),
+				column: Number(match[4])
+			});
+		}
+	}
+	flushPending();
+	return frames;
+}
+/**
+* The most specific label for an error: its constructor (class) name when it is
+* more descriptive than the generic `Error`. A subclass like `TestError` keeps
+* `error.name === 'Error'` unless it explicitly sets `name`, but its
+* constructor name is still `TestError`.
+*/
+function errorLabel(error) {
+	const constructorName = error.constructor?.name;
+	if (constructorName && constructorName !== "Error" && constructorName !== "Object") return constructorName;
+	return error.name || "Error";
+}
+function isApplicationFile(file) {
+	if (!file) return false;
+	return !file.includes("node_modules") && !file.includes("/deps/") && !file.startsWith("node:") && !file.includes("/rustc/") && !file.includes("/rustlib/") && !file.includes("/.cargo/registry");
+}
+/** Collapse `foo/../` segments (e.g. Rust's `.ossido/../src/...` → `src/...`). */
+function collapseParentDirs(path) {
+	const out = [];
+	for (const part of path.split("/")) {
+		const prev = out[out.length - 1];
+		if (part === ".." && prev !== void 0 && prev !== "" && prev !== "..") out.pop();
+		else out.push(part);
+	}
+	return out.join("/");
+}
+/** Strip origin and query for a readable path. */
+function prettyPath(file) {
+	const withoutQuery = file.replace(/\?.*$/, "");
+	let pathname = withoutQuery;
+	try {
+		pathname = new URL(withoutQuery).pathname;
+	} catch {}
+	return collapseParentDirs(pathname.replace(/^\/vite-server/, "").replace(/^\/@fs/, ""));
+}
+/** Resolve a sourcemap `source` (relative) against the served module path. */
+function resolveSourcePath(frameFile, source) {
+	const clean = frameFile.replace(/\?.*$/, "");
+	try {
+		const url = new URL(clean);
+		return new URL(source, `https://host${url.pathname}`).pathname.replace(/^\/vite-server/, "").replace(/^\/@fs/, "");
+	} catch {
+		return source;
+	}
+}
+function extensionOf(file) {
+	const match = file.replace(/\?.*$/, "").match(/\.(tsx|ts|jsx|js|mjs|cjs|rs)$/);
+	return match ? `.${match[1]}` : ".js";
+}
+/** Immediate (unmapped) frames for the first paint before async resolution. */
+function initialFrames(stack) {
+	return parseStack(stack).map((frame) => ({
+		fn: frame.fn,
+		file: frame.file ? prettyPath(frame.file) : void 0,
+		line: frame.line,
+		column: frame.column,
+		isApp: isApplicationFile(frame.file)
+	}));
+}
+async function loadSourceMap(moduleUrl, cache, TraceMapCtor) {
+	const key = moduleUrl.replace(/\?.*$/, "");
+	const cached = cache.get(key);
+	if (cached !== void 0) return cached;
+	let map = null;
+	try {
+		let json = null;
+		const mapResponse = await fetch(`${key}.map`);
+		if (mapResponse.ok) json = await mapResponse.json();
+		else {
+			const moduleResponse = await fetch(moduleUrl);
+			if (moduleResponse.ok) {
+				const inline = (await moduleResponse.text()).match(/sourceMappingURL=data:application\/json;(?:charset=[^;,]+;)?base64,([A-Za-z0-9+/=]+)/);
+				if (inline?.[1]) json = JSON.parse(atob(inline[1]));
+			}
+		}
+		if (json) map = new TraceMapCtor(json);
+	} catch {
+		map = null;
+	}
+	cache.set(key, map);
+	return map;
+}
+/**
+* Pull the per-line `<span class="line">` elements out of Shiki's `codeToHast`
+* output (`root > pre > code > span.line*`). Shiki already delimits lines, so no
+* manual line-splitting is needed.
+*/
+function extractLineNodes(tree) {
+	return ((tree.children.find((node) => node.type === "element" && node.tagName === "pre")?.children.find((node) => node.type === "element" && node.tagName === "code"))?.children ?? []).filter((node) => node.type === "element" && node.properties?.["class"] === "line").map((line) => line.children);
+}
+/**
+* Slice the source into the context window around the throwing line, as plain
+* text. Synchronous and dependency-free, so the excerpt can render immediately;
+* syntax highlighting then swaps in over the same layout (see
+* {@link highlightExcerpt}).
+*/
+function extractExcerpt(src) {
+	const allLines = src.content.split("\n");
+	const start = Math.max(1, src.line - SOURCE_CONTEXT);
+	const end = Math.min(allLines.length, src.line + SOURCE_CONTEXT);
+	const lines = [];
+	for (let number = start; number <= end; number++) lines.push({
+		number,
+		text: allLines[number - 1] ?? "",
+		isErrorLine: number === src.line
+	});
+	return {
+		file: src.file,
+		line: src.line,
+		column: src.column,
+		lines
+	};
+}
+function buildExcerpt(highlighter, toHtml, source, file, errorLine, errorColumn) {
+	const lines = extractLineNodes(highlighter.codeToHast(source, {
+		lang: langForFile(file),
+		theme: "github-dark"
+	}));
+	const start = Math.max(1, errorLine - SOURCE_CONTEXT);
+	const end = Math.min(lines.length, errorLine + SOURCE_CONTEXT);
+	const highlighted = [];
+	for (let number = start; number <= end; number++) highlighted.push({
+		number,
+		html: toHtml({
+			type: "root",
+			children: lines[number - 1] ?? []
+		}),
+		isErrorLine: number === errorLine
+	});
+	return {
+		file,
+		line: errorLine,
+		column: errorColumn,
+		lines: highlighted
+	};
+}
+let highlighterPromise = null;
+/**
+* Build a fine-grained Shiki highlighter: the tree-shakeable core, the pure-JS
+* regex engine (no oniguruma WASM), and only the four grammars the overlay needs
+* plus one theme. This keeps the dev-only chunk small and avoids a WASM fetch on
+* the dev critical path.
+*/
+async function getHighlighter() {
+	if (!highlighterPromise) highlighterPromise = (async () => {
+		const [{ createHighlighterCore }, { createJavaScriptRegexEngine }] = await Promise.all([import("shiki/core"), import("shiki/engine/javascript")]);
+		const [tsx, ts, js, rust, theme] = await Promise.all([
+			import("@shikijs/langs/tsx"),
+			import("@shikijs/langs/typescript"),
+			import("@shikijs/langs/javascript"),
+			import("@shikijs/langs/rust"),
+			import("@shikijs/themes/github-dark")
+		]);
+		return createHighlighterCore({
+			themes: [theme.default],
+			langs: [
+				tsx.default,
+				ts.default,
+				js.default,
+				rust.default
+			],
+			engine: createJavaScriptRegexEngine()
+		});
+	})();
+	return highlighterPromise;
+}
+/**
+* Eagerly kick off the heavy, dev-only imports (Shiki core + engine + grammars,
+* trace-mapping, hast-util-to-html) so the first error's source excerpt renders
+* without waiting on library loading. Safe to call repeatedly — the imports are
+* cached. Call it when the overlay host mounts.
+*/
+function warmDevErrorSource() {
+	getHighlighter();
+	import("@jridgewell/trace-mapping");
+	import("hast-util-to-html");
+}
+/**
+* Syntax-highlight a source excerpt (Shiki picks the grammar from the file
+* extension, e.g. `.tsx` or `.rs`). Returns `null` if the dev-only libraries
+* fail to load — the caller keeps showing the plain excerpt.
+*/
+async function highlightExcerpt(src) {
+	try {
+		const [highlighter, htmlModule] = await Promise.all([getHighlighter(), import("hast-util-to-html")]);
+		const toHtml = htmlModule.toHtml;
+		return buildExcerpt(highlighter, toHtml, src.content, src.file, src.line, src.column);
+	} catch {
+		return null;
+	}
+}
+/**
+* Resolve stack frames to original locations (via each module's sourcemap) and
+* return the raw source content of the top application frame — WITHOUT
+* highlighting it, so the caller can render a plain excerpt immediately and
+* highlight it asynchronously. Falls back to unmapped frames if trace-mapping
+* fails to load.
+*/
+async function resolveDevErrorFrames(stack) {
+	const rawFrames = parseStack(stack);
+	try {
+		const { TraceMap, originalPositionFor, sourceContentFor } = await import("@jridgewell/trace-mapping");
+		const mapCache = /* @__PURE__ */ new Map();
+		const frames = [];
+		let source = null;
+		for (const frame of rawFrames) {
+			if (!frame.file || frame.line == null) {
+				frames.push({
+					fn: frame.fn,
+					isApp: false
+				});
+				continue;
+			}
+			const isApp = isApplicationFile(frame.file);
+			let file = prettyPath(frame.file);
+			let line = frame.line;
+			let column = frame.column ?? 1;
+			let content = null;
+			if (isApp) {
+				const map = await loadSourceMap(frame.file, mapCache, TraceMap);
+				if (map) {
+					const original = originalPositionFor(map, {
+						line: frame.line,
+						column: (frame.column ?? 1) - 1
+					});
+					if (original.source != null && original.line != null) {
+						file = resolveSourcePath(frame.file, original.source);
+						line = original.line;
+						column = (original.column ?? 0) + 1;
+						content = sourceContentFor(map, original.source);
+					}
+				}
+			}
+			frames.push({
+				fn: frame.fn,
+				file,
+				line,
+				column,
+				isApp
+			});
+			if (!source && isApp && content) source = {
+				content,
+				file,
+				line,
+				column
+			};
+		}
+		return {
+			frames,
+			source
+		};
+	} catch {
+		return {
+			frames: initialFrames(stack),
+			source: null
+		};
+	}
+}
+
+//#endregion
+export { errorLabel, extractExcerpt, highlightExcerpt, initialFrames, parseStack, prettyPath, resolveDevErrorFrames, warmDevErrorSource };
+//# sourceMappingURL=devErrorSource.js.map

package/dist/esm/components/devErrorSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devErrorSource.js","names":[],"sources":["../../../src/components/devErrorSource.ts"],"sourcesContent":["import type { TraceMap } from '@jridgewell/trace-mapping';\nimport type { HighlighterCore } from 'shiki/core';\n\n// Minimal hast shapes (avoids a direct dependency on `@types/hast`).\ninterface HastText {\n  type: 'text';\n  value: string;\n}\ninterface HastElement {\n  type: 'element';\n  tagName: string;\n  properties?: Record<string, unknown>;\n  children: Array<HastNode>;\n}\ntype HastNode = HastText | HastElement;\ntype ToHtml = (tree: { type: 'root'; children: Array<HastNode> }) => string;\n\n/**\n * Dev-only pipeline for the error overlay. Resolves a browser stack trace to\n * original source locations (via each module's sourcemap), then extracts and\n * syntax-highlights (Shiki) the source excerpt around the throwing expression.\n * Everything here is dynamically imported so it never ships in the production\n * client bundle.\n */\n\ninterface RawFrame {\n  fn?: string;\n  file?: string;\n  line?: number;\n  column?: number;\n}\n\nexport interface ResolvedFrame {\n  fn?: string;\n  file?: string;\n  line?: number;\n  column?: number;\n  isApp: boolean;\n}\n\nexport interface HighlightedLine {\n  number: number;\n  /** Pre-highlighted HTML for the line (from Shiki, inline-styled). */\n  html: string;\n  isErrorLine: boolean;\n}\n\n/** A single source line as plain text — shown before highlighting is ready. */\nexport interface PlainLine {\n  number: number;\n  text: string;\n  isErrorLine: boolean;\n}\n\nexport interface SourceExcerpt {\n  file: string;\n  line: number;\n  column: number;\n  lines: Array<HighlightedLine>;\n}\n\n/** The excerpt in plain text, before Shiki has highlighted it. */\nexport interface PlainExcerpt {\n  file: string;\n  line: number;\n  column: number;\n  lines: Array<PlainLine>;\n}\n\n/** Source content around a throwing location — the input to an excerpt. */\nexport interface RawExcerptSource {\n  content: string;\n  file: string;\n  line: number;\n  column: number;\n}\n\nconst SOURCE_CONTEXT = 5;\n\n/** Map a source file extension to the Shiki grammar (language) to load. */\nfunction langForFile(\n  file: string,\n): 'tsx' | 'typescript' | 'javascript' | 'rust' {\n  switch (extensionOf(file)) {\n    case '.tsx':\n    case '.jsx':\n      return 'tsx';\n    case '.ts':\n      return 'typescript';\n    case '.rs':\n      return 'rust';\n    default:\n      return 'javascript';\n  }\n}\n\n// V8 / Chrome: `fn (url:line:col)` or `url:line:col` (after the `at ` prefix).\nconst V8_LINE = /^(?:(.*?)\\s+)?\\(?([^()]+):(\\d+):(\\d+)\\)?$/;\n// SpiderMonkey / JavaScriptCore (Firefox, Safari): `fn@url:line:col`\n// (`fn` may be empty). The url itself can contain `@` (vite's `@fs`), so the\n// function name is only the part before the FIRST `@`.\nconst SPIDERMONKEY_LINE = /^(.*?)@(.+):(\\d+):(\\d+)$/;\n// Rust backtrace frame header: `<n>: <symbol>`, e.g. `10: my_app::route::handler`.\n// Its `at <file>:<line>:<col>` location, when present, is on the following line.\nconst RUST_FRAME = /^\\d+:\\s+(.+)$/;\n\nexport function parseStack(stack: string | undefined): Array<RawFrame> {\n  if (!stack) return [];\n\n  const frames: Array<RawFrame> = [];\n  // A Rust frame symbol awaiting its (optional) `at <file>:<line>:<col>` line.\n  let pendingFn: string | undefined;\n\n  const flushPending = (): void => {\n    if (pendingFn !== undefined) {\n      frames.push({ fn: pendingFn });\n      pendingFn = undefined;\n    }\n  };\n\n  for (const rawLine of stack.split('\\n')) {\n    const line = rawLine.trim();\n    if (!line) continue;\n\n    const rustFrame = line.match(RUST_FRAME);\n    if (rustFrame) {\n      // A new symbol: the previous one had no location line, emit it as-is.\n      flushPending();\n      pendingFn = rustFrame[1];\n      continue;\n    }\n\n    if (line.startsWith('at ')) {\n      const match = line.slice(3).trim().match(V8_LINE);\n      if (match) {\n        frames.push({\n          // Prefer a Rust symbol captured from the preceding frame header.\n          fn: pendingFn ?? (match[1]?.trim() || undefined),\n          file: match[2],\n          line: Number(match[3]),\n          column: Number(match[4]),\n        });\n      } else {\n        frames.push({ fn: pendingFn ?? line.slice(3).trim() });\n      }\n      pendingFn = undefined;\n      continue;\n    }\n\n    const match = line.match(SPIDERMONKEY_LINE);\n    if (match) {\n      flushPending();\n      frames.push({\n        fn: match[1] || undefined,\n        file: match[2],\n        line: Number(match[3]),\n        column: Number(match[4]),\n      });\n    }\n  }\n\n  flushPending();\n  return frames;\n}\n\n/**\n * The most specific label for an error: its constructor (class) name when it is\n * more descriptive than the generic `Error`. A subclass like `TestError` keeps\n * `error.name === 'Error'` unless it explicitly sets `name`, but its\n * constructor name is still `TestError`.\n */\nexport function errorLabel(error: Error): string {\n  const constructorName = error.constructor?.name;\n  if (\n    constructorName &&\n    constructorName !== 'Error' &&\n    constructorName !== 'Object'\n  ) {\n    return constructorName;\n  }\n  return error.name || 'Error';\n}\n\nfunction isApplicationFile(file: string | undefined): boolean {\n  if (!file) return false;\n  return (\n    !file.includes('node_modules') &&\n    !file.includes('/deps/') &&\n    !file.startsWith('node:') &&\n    // Rust stdlib / toolchain / registry frames are vendor noise, not app code.\n    !file.includes('/rustc/') &&\n    !file.includes('/rustlib/') &&\n    !file.includes('/.cargo/registry')\n  );\n}\n\n/** Collapse `foo/../` segments (e.g. Rust's `.ossido/../src/...` → `src/...`). */\nfunction collapseParentDirs(path: string): string {\n  const out: Array<string> = [];\n  for (const part of path.split('/')) {\n    const prev = out[out.length - 1];\n    if (part === '..' && prev !== undefined && prev !== '' && prev !== '..') {\n      out.pop();\n    } else {\n      out.push(part);\n    }\n  }\n  return out.join('/');\n}\n\n/** Strip origin and query for a readable path. */\nexport function prettyPath(file: string): string {\n  const withoutQuery = file.replace(/\\?.*$/, '');\n  let pathname = withoutQuery;\n  try {\n    pathname = new URL(withoutQuery).pathname;\n  } catch {\n    // already a path\n  }\n  return collapseParentDirs(\n    pathname.replace(/^\\/vite-server/, '').replace(/^\\/@fs/, ''),\n  );\n}\n\n/** Resolve a sourcemap `source` (relative) against the served module path. */\nfunction resolveSourcePath(frameFile: string, source: string): string {\n  const clean = frameFile.replace(/\\?.*$/, '');\n  try {\n    const url = new URL(clean);\n    const resolved = new URL(source, `https://host${url.pathname}`).pathname;\n    return resolved.replace(/^\\/vite-server/, '').replace(/^\\/@fs/, '');\n  } catch {\n    return source;\n  }\n}\n\nfunction extensionOf(file: string): string {\n  const match = file\n    .replace(/\\?.*$/, '')\n    .match(/\\.(tsx|ts|jsx|js|mjs|cjs|rs)$/);\n  return match ? `.${match[1]}` : '.js';\n}\n\n/** Immediate (unmapped) frames for the first paint before async resolution. */\nexport function initialFrames(stack: string | undefined): Array<ResolvedFrame> {\n  return parseStack(stack).map((frame) => ({\n    fn: frame.fn,\n    file: frame.file ? prettyPath(frame.file) : undefined,\n    line: frame.line,\n    column: frame.column,\n    isApp: isApplicationFile(frame.file),\n  }));\n}\n\nasync function loadSourceMap(\n  moduleUrl: string,\n  cache: Map<string, TraceMap | null>,\n  TraceMapCtor: typeof TraceMap,\n): Promise<TraceMap | null> {\n  const key = moduleUrl.replace(/\\?.*$/, '');\n  const cached = cache.get(key);\n  if (cached !== undefined) return cached;\n\n  let map: TraceMap | null = null;\n  try {\n    let json: unknown = null;\n    const mapResponse = await fetch(`${key}.map`);\n    if (mapResponse.ok) {\n      json = await mapResponse.json();\n    } else {\n      const moduleResponse = await fetch(moduleUrl);\n      if (moduleResponse.ok) {\n        const text = await moduleResponse.text();\n        const inline = text.match(\n          /sourceMappingURL=data:application\\/json;(?:charset=[^;,]+;)?base64,([A-Za-z0-9+/=]+)/,\n        );\n        if (inline?.[1]) json = JSON.parse(atob(inline[1]));\n      }\n    }\n    if (json)\n      map = new TraceMapCtor(json as ConstructorParameters<typeof TraceMap>[0]);\n  } catch {\n    map = null;\n  }\n\n  cache.set(key, map);\n  return map;\n}\n\n/**\n * Pull the per-line `<span class=\"line\">` elements out of Shiki's `codeToHast`\n * output (`root > pre > code > span.line*`). Shiki already delimits lines, so no\n * manual line-splitting is needed.\n */\nfunction extractLineNodes(tree: {\n  children: Array<HastNode>;\n}): Array<Array<HastNode>> {\n  const pre = tree.children.find(\n    (node): node is HastElement =>\n      node.type === 'element' && node.tagName === 'pre',\n  );\n  const code = pre?.children.find(\n    (node): node is HastElement =>\n      node.type === 'element' && node.tagName === 'code',\n  );\n  // Shiki tags each line as `<span class=\"line\">` (a raw `class` string, not the\n  // hast-normalized `className` array), separated by `\\n` text nodes.\n  const lineNodes = (code?.children ?? []).filter(\n    (node): node is HastElement =>\n      node.type === 'element' && node.properties?.['class'] === 'line',\n  );\n  return lineNodes.map((line) => line.children);\n}\n\n/**\n * Slice the source into the context window around the throwing line, as plain\n * text. Synchronous and dependency-free, so the excerpt can render immediately;\n * syntax highlighting then swaps in over the same layout (see\n * {@link highlightExcerpt}).\n */\nexport function extractExcerpt(src: RawExcerptSource): PlainExcerpt {\n  const allLines = src.content.split('\\n');\n  const start = Math.max(1, src.line - SOURCE_CONTEXT);\n  const end = Math.min(allLines.length, src.line + SOURCE_CONTEXT);\n  const lines: Array<PlainLine> = [];\n  for (let number = start; number <= end; number++) {\n    lines.push({\n      number,\n      text: allLines[number - 1] ?? '',\n      isErrorLine: number === src.line,\n    });\n  }\n  return { file: src.file, line: src.line, column: src.column, lines };\n}\n\nfunction buildExcerpt(\n  highlighter: HighlighterCore,\n  toHtml: ToHtml,\n  source: string,\n  file: string,\n  errorLine: number,\n  errorColumn: number,\n): SourceExcerpt {\n  const tree = highlighter.codeToHast(source, {\n    lang: langForFile(file),\n    theme: 'github-dark',\n  }) as unknown as { children: Array<HastNode> };\n  const lines = extractLineNodes(tree);\n\n  const start = Math.max(1, errorLine - SOURCE_CONTEXT);\n  const end = Math.min(lines.length, errorLine + SOURCE_CONTEXT);\n\n  const highlighted: Array<HighlightedLine> = [];\n  for (let number = start; number <= end; number++) {\n    highlighted.push({\n      number,\n      html: toHtml({ type: 'root', children: lines[number - 1] ?? [] }),\n      isErrorLine: number === errorLine,\n    });\n  }\n\n  return { file, line: errorLine, column: errorColumn, lines: highlighted };\n}\n\nlet highlighterPromise: Promise<HighlighterCore> | null = null;\n\n/**\n * Build a fine-grained Shiki highlighter: the tree-shakeable core, the pure-JS\n * regex engine (no oniguruma WASM), and only the four grammars the overlay needs\n * plus one theme. This keeps the dev-only chunk small and avoids a WASM fetch on\n * the dev critical path.\n */\nasync function getHighlighter(): Promise<HighlighterCore> {\n  if (!highlighterPromise) {\n    highlighterPromise = (async (): Promise<HighlighterCore> => {\n      const [{ createHighlighterCore }, { createJavaScriptRegexEngine }] =\n        await Promise.all([\n          import('shiki/core'),\n          import('shiki/engine/javascript'),\n        ]);\n      const [tsx, ts, js, rust, theme] = await Promise.all([\n        import('@shikijs/langs/tsx'),\n        import('@shikijs/langs/typescript'),\n        import('@shikijs/langs/javascript'),\n        import('@shikijs/langs/rust'),\n        import('@shikijs/themes/github-dark'),\n      ]);\n      return createHighlighterCore({\n        themes: [theme.default],\n        langs: [tsx.default, ts.default, js.default, rust.default],\n        engine: createJavaScriptRegexEngine(),\n      });\n    })();\n  }\n  return highlighterPromise;\n}\n\n/**\n * Eagerly kick off the heavy, dev-only imports (Shiki core + engine + grammars,\n * trace-mapping, hast-util-to-html) so the first error's source excerpt renders\n * without waiting on library loading. Safe to call repeatedly — the imports are\n * cached. Call it when the overlay host mounts.\n */\nexport function warmDevErrorSource(): void {\n  void getHighlighter();\n  void import('@jridgewell/trace-mapping');\n  void import('hast-util-to-html');\n}\n\n/**\n * Syntax-highlight a source excerpt (Shiki picks the grammar from the file\n * extension, e.g. `.tsx` or `.rs`). Returns `null` if the dev-only libraries\n * fail to load — the caller keeps showing the plain excerpt.\n */\nexport async function highlightExcerpt(\n  src: RawExcerptSource,\n): Promise<SourceExcerpt | null> {\n  try {\n    const [highlighter, htmlModule] = await Promise.all([\n      getHighlighter(),\n      import('hast-util-to-html'),\n    ]);\n    const toHtml = htmlModule.toHtml as unknown as ToHtml;\n    return buildExcerpt(\n      highlighter,\n      toHtml,\n      src.content,\n      src.file,\n      src.line,\n      src.column,\n    );\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve stack frames to original locations (via each module's sourcemap) and\n * return the raw source content of the top application frame — WITHOUT\n * highlighting it, so the caller can render a plain excerpt immediately and\n * highlight it asynchronously. Falls back to unmapped frames if trace-mapping\n * fails to load.\n */\nexport async function resolveDevErrorFrames(\n  stack: string | undefined,\n): Promise<{ frames: Array<ResolvedFrame>; source: RawExcerptSource | null }> {\n  const rawFrames = parseStack(stack);\n\n  try {\n    const { TraceMap, originalPositionFor, sourceContentFor } =\n      await import('@jridgewell/trace-mapping');\n\n    const mapCache = new Map<string, TraceMap | null>();\n    const frames: Array<ResolvedFrame> = [];\n    let source: RawExcerptSource | null = null;\n\n    for (const frame of rawFrames) {\n      if (!frame.file || frame.line == null) {\n        frames.push({ fn: frame.fn, isApp: false });\n        continue;\n      }\n\n      const isApp = isApplicationFile(frame.file);\n      let file = prettyPath(frame.file);\n      let line = frame.line;\n      let column = frame.column ?? 1;\n      let content: string | null | undefined = null;\n\n      // Only application frames are worth mapping (vendor frames are noise).\n      if (isApp) {\n        const map = await loadSourceMap(frame.file, mapCache, TraceMap);\n        if (map) {\n          const original = originalPositionFor(map, {\n            line: frame.line,\n            column: (frame.column ?? 1) - 1,\n          });\n          if (original.source != null && original.line != null) {\n            file = resolveSourcePath(frame.file, original.source);\n            line = original.line;\n            column = (original.column ?? 0) + 1;\n            content = sourceContentFor(map, original.source);\n          }\n        }\n      }\n\n      frames.push({ fn: frame.fn, file, line, column, isApp });\n\n      // Keep the top application frame's source for the excerpt.\n      if (!source && isApp && content) {\n        source = { content, file, line, column };\n      }\n    }\n\n    return { frames, source };\n  } catch {\n    return { frames: initialFrames(stack), source: null };\n  }\n}\n"],"mappings":"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"}

package/dist/esm/components/devErrorStore.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Development-only store that aggregates every kind of dev error behind one
+ * overlay: React render errors (and SSR/Rust panics) caught by the route error
+ * boundary, uncaught `window` errors, unhandled promise rejections, and Vite
+ * build/compile errors. {@link DevErrorOverlayHost} subscribes to it via
+ * `useSyncExternalStore` and renders a persistent dev indicator + browsable
+ * error overlay.
+ *
+ * The store is a module singleton (not React state) so it exists before the
+ * overlay mounts and independently of which subtree threw. It is also published
+ * on `window.__OSSIDO_DEV_ERRORS__` so the Vite HMR client — patched by
+ * `ErrorOverlayVitePlugin`, which runs outside the module system — can report
+ * build errors into it without needing `import.meta.hot`.
+ */
+/** The distinct sources an aggregated error can come from. */
+export type DevErrorKind = 'runtime' | 'uncaught' | 'unhandledrejection' | 'build';
+/**
+ * A Vite build/compile error (a subset of Vite's `ErrorPayload['err']`). Kept
+ * structural rather than importing from `vite` so this module carries no build
+ * dependency.
+ */
+export interface DevBuildError {
+    message: string;
+    stack?: string;
+    id?: string;
+    frame?: string;
+    plugin?: string;
+    loc?: {
+        file?: string;
+        line?: number;
+        column?: number;
+    };
+}
+export interface DevErrorEntry {
+    id: number;
+    kind: DevErrorKind;
+    /** Present for JS errors (`runtime` / `uncaught` / `unhandledrejection`). */
+    error?: Error;
+    /** Present for `build` errors. */
+    build?: DevBuildError;
+    /** Only in-place-resettable errors (the route boundary) carry a reset. */
+    reset?: () => void;
+    /** How many times this identical error has been reported (dedup counter). */
+    occurrences: number;
+    /** Dedup key — identical errors collapse to a single entry. */
+    signature: string;
+}
+/** Which screen corner the dev indicator sits in. */
+export type DevOverlayCorner = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+export declare const DEV_OVERLAY_CORNERS: ReadonlyArray<DevOverlayCorner>;
+export interface DevErrorState {
+    entries: ReadonlyArray<DevErrorEntry>;
+    /** Index of the entry currently shown in the pager. */
+    activeIndex: number;
+    /** The full error overlay is open (only meaningful when there are errors). */
+    overlayOpen: boolean;
+    /** The indicator's menu popover is open. */
+    menuOpen: boolean;
+    /** The user hid the idle indicator for this session (errors still force it). */
+    badgeHidden: boolean;
+    /** Which corner the indicator sits in (persisted across reloads). */
+    position: DevOverlayCorner;
+}
+declare class DevErrorStore {
+    private entries;
+    private activeIndex;
+    private overlayOpen;
+    private menuOpen;
+    private badgeHidden;
+    private position;
+    private nextId;
+    private listeners;
+    private snapshot;
+    constructor();
+    subscribe: (listener: () => void) => (() => void);
+    getSnapshot: () => DevErrorState;
+    getServerSnapshot: () => DevErrorState;
+    private commit;
+    /** Add (or refresh) a JS error. Returns its id so the reporter can remove it. */
+    addJsError: (kind: Exclude<DevErrorKind, "build">, error: Error, reset?: () => void) => number;
+    /** Report a Vite build error — replaces any previous one. */
+    addBuildError: (build: DevBuildError) => number;
+    /** Clear the current build error (called when Vite reports a successful update). */
+    clearBuildErrors: () => void;
+    removeById: (id: number) => void;
+    setActiveIndex: (index: number) => void;
+    next: () => void;
+    prev: () => void;
+    /** Open the full error overlay (from the indicator menu's "View errors"). */
+    openOverlay: () => void;
+    /** Close the overlay back to the indicator (X / Esc / click-away). */
+    closeOverlay: () => void;
+    toggleMenu: () => void;
+    closeMenu: () => void;
+    /** Hide the idle indicator for this session (a new error still forces it back). */
+    hideBadge: () => void;
+    setPosition: (corner: DevOverlayCorner) => void;
+    /**
+     * Publish the store on `window` and drain any errors buffered by the Vite
+     * client before this module loaded. Safe to call repeatedly.
+     */
+    installBridge(): void;
+}
+export declare const devErrorStore: DevErrorStore;
+export {};

package/dist/esm/components/devErrorStore.js

@@ -0,0 +1,186 @@
+//#region src/components/devErrorStore.ts
+const DEV_OVERLAY_CORNERS = [
+	"top-left",
+	"top-right",
+	"bottom-left",
+	"bottom-right"
+];
+const DEFAULT_CORNER = "bottom-left";
+const CORNER_STORAGE_KEY = "ossido:dev-overlay-corner";
+/** The corner is a persisted preference; hiding the badge is per-session. */
+function loadCorner() {
+	try {
+		const stored = globalThis.localStorage?.getItem(CORNER_STORAGE_KEY);
+		if (stored && DEV_OVERLAY_CORNERS.includes(stored)) return stored;
+	} catch {}
+	return DEFAULT_CORNER;
+}
+function saveCorner(corner) {
+	try {
+		globalThis.localStorage?.setItem(CORNER_STORAGE_KEY, corner);
+	} catch {}
+}
+const EMPTY_STATE = {
+	entries: [],
+	activeIndex: 0,
+	overlayOpen: false,
+	menuOpen: false,
+	badgeHidden: false,
+	position: DEFAULT_CORNER
+};
+const BRIDGE_KEY = "__OSSIDO_DEV_ERRORS__";
+const BUFFER_KEY = "__OSSIDO_DEV_ERRORS_BUFFER__";
+function jsSignature(error) {
+	return `${error.name}:${error.message}:${(error.stack ?? "").slice(0, 200)}`;
+}
+const BUILD_SIGNATURE = "build";
+var DevErrorStore = class {
+	constructor() {
+		this.entries = [];
+		this.activeIndex = 0;
+		this.overlayOpen = false;
+		this.menuOpen = false;
+		this.badgeHidden = false;
+		this.position = loadCorner();
+		this.nextId = 1;
+		this.listeners = /* @__PURE__ */ new Set();
+		this.snapshot = EMPTY_STATE;
+		this.subscribe = (listener) => {
+			this.listeners.add(listener);
+			return () => {
+				this.listeners.delete(listener);
+			};
+		};
+		this.getSnapshot = () => this.snapshot;
+		this.getServerSnapshot = () => EMPTY_STATE;
+		this.addJsError = (kind, error, reset) => {
+			const signature = jsSignature(error);
+			const existing = this.entries.find((e) => e.signature === signature);
+			if (existing) {
+				if (kind === "runtime") {
+					existing.kind = "runtime";
+					existing.reset = reset ?? existing.reset;
+				}
+				existing.occurrences += 1;
+				this.activeIndex = this.entries.indexOf(existing);
+				this.overlayOpen = true;
+				this.commit();
+				return existing.id;
+			}
+			const entry = {
+				id: this.nextId++,
+				kind,
+				error,
+				reset,
+				occurrences: 1,
+				signature
+			};
+			this.entries.push(entry);
+			this.activeIndex = this.entries.length - 1;
+			this.overlayOpen = true;
+			this.commit();
+			return entry.id;
+		};
+		this.addBuildError = (build) => {
+			this.entries = this.entries.filter((e) => e.kind !== "build");
+			const entry = {
+				id: this.nextId++,
+				kind: "build",
+				build,
+				occurrences: 1,
+				signature: BUILD_SIGNATURE
+			};
+			this.entries.push(entry);
+			this.activeIndex = this.entries.length - 1;
+			this.overlayOpen = true;
+			this.commit();
+			return entry.id;
+		};
+		this.clearBuildErrors = () => {
+			if (!this.entries.some((e) => e.kind === "build")) return;
+			this.entries = this.entries.filter((e) => e.kind !== "build");
+			this.commit();
+		};
+		this.removeById = (id) => {
+			const next = this.entries.filter((e) => e.id !== id);
+			if (next.length === this.entries.length) return;
+			this.entries = next;
+			this.commit();
+		};
+		this.setActiveIndex = (index) => {
+			this.activeIndex = index;
+			this.commit();
+		};
+		this.next = () => {
+			if (this.entries.length === 0) return;
+			this.activeIndex = (this.activeIndex + 1) % this.entries.length;
+			this.commit();
+		};
+		this.prev = () => {
+			if (this.entries.length === 0) return;
+			this.activeIndex = (this.activeIndex - 1 + this.entries.length) % this.entries.length;
+			this.commit();
+		};
+		this.openOverlay = () => {
+			this.overlayOpen = true;
+			this.menuOpen = false;
+			this.commit();
+		};
+		this.closeOverlay = () => {
+			this.overlayOpen = false;
+			this.commit();
+		};
+		this.toggleMenu = () => {
+			this.menuOpen = !this.menuOpen;
+			this.commit();
+		};
+		this.closeMenu = () => {
+			if (!this.menuOpen) return;
+			this.menuOpen = false;
+			this.commit();
+		};
+		this.hideBadge = () => {
+			this.badgeHidden = true;
+			this.menuOpen = false;
+			this.commit();
+		};
+		this.setPosition = (corner) => {
+			this.position = corner;
+			saveCorner(corner);
+			this.commit();
+		};
+		this.commit();
+	}
+	commit() {
+		this.activeIndex = Math.min(Math.max(this.activeIndex, 0), Math.max(this.entries.length - 1, 0));
+		this.snapshot = {
+			entries: this.entries.slice(),
+			activeIndex: this.activeIndex,
+			overlayOpen: this.overlayOpen && this.entries.length > 0,
+			menuOpen: this.menuOpen,
+			badgeHidden: this.badgeHidden,
+			position: this.position
+		};
+		for (const listener of this.listeners) listener();
+	}
+	/**
+	* Publish the store on `window` and drain any errors buffered by the Vite
+	* client before this module loaded. Safe to call repeatedly.
+	*/
+	installBridge() {
+		if (typeof window === "undefined") return;
+		const globalWindow = window;
+		globalWindow[BRIDGE_KEY] = this;
+		const buffered = globalWindow[BUFFER_KEY];
+		if (buffered?.length) {
+			for (const build of buffered) this.addBuildError(build);
+			globalWindow[BUFFER_KEY] = [];
+		}
+	}
+};
+const devErrorStore = new DevErrorStore();
+devErrorStore.installBridge();
+
+//#endregion
+export { DEV_OVERLAY_CORNERS, devErrorStore };
+//# sourceMappingURL=devErrorStore.js.map