@ulearning/ai-generative-frame 0.0.0-stage → 1.0.0-next.0

package/dist/protocol.js

@@ -0,0 +1,49 @@
+// src/protocol.ts
+const GENFRAME_PROTOCOL_VERSION = "2026-01-26";
+/** Window messages exchanged once, before the private port exists. */
+const READY_MESSAGE = "genframe:ready";
+const INIT_MESSAGE = "genframe:init";
+const METHODS = {
+	write: "genframe/write",
+	end: "genframe/end",
+	replace: "genframe/replace",
+	screenshot: "genframe/screenshot",
+	inspect: "genframe/inspect",
+	clearStorage: "genframe/clear-storage",
+	hostContextChanged: "ui/notifications/host-context-changed",
+	toolInputPartial: "ui/notifications/tool-input-partial",
+	toolInput: "ui/notifications/tool-input",
+	toolResult: "ui/notifications/tool-result",
+	ready: "genframe/ready",
+	initialize: "ui/initialize",
+	initialized: "ui/notifications/initialized",
+	sizeChanged: "ui/notifications/size-changed",
+	openLink: "ui/open-link",
+	message: "ui/message",
+	callTool: "tools/call",
+	requestDisplayMode: "ui/request-display-mode",
+	updateModelContext: "ui/update-model-context",
+	copyText: "genframe/copy-text",
+	widgetState: "genframe/widget-state",
+	log: "genframe/log",
+	error: "genframe/error"
+};
+const SVG_TAG = /^<svg[\s>/]/i;
+/** Classifies widget code: SVG when it starts with an `<svg` element, otherwise HTML. */
+function detectWidgetKind(code) {
+	let rest = code.trimStart();
+	if (rest.startsWith("<?xml")) {
+		const end = rest.indexOf(">");
+		if (end === -1) return "html";
+		rest = rest.slice(end + 1).trimStart();
+	}
+	while (rest.startsWith("<!--")) {
+		const end = rest.indexOf("-->", 4);
+		if (end === -1) return "html";
+		rest = rest.slice(end + 3).trimStart();
+	}
+	return SVG_TAG.test(rest) ? "svg" : "html";
+}
+export { GENFRAME_PROTOCOL_VERSION, INIT_MESSAGE, METHODS, READY_MESSAGE, detectWidgetKind };
+
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","names":[],"sources":["../src/protocol.ts"],"sourcesContent":["export const GENFRAME_PROTOCOL_VERSION = \"2026-01-26\";\n\n/** Window messages exchanged once, before the private port exists. */\nexport const READY_MESSAGE = \"genframe:ready\";\nexport const INIT_MESSAGE = \"genframe:init\";\n\nexport const METHODS = {\n  // host → frame\n  write: \"genframe/write\",\n  end: \"genframe/end\",\n  replace: \"genframe/replace\",\n  screenshot: \"genframe/screenshot\",\n  inspect: \"genframe/inspect\",\n  clearStorage: \"genframe/clear-storage\",\n  hostContextChanged: \"ui/notifications/host-context-changed\",\n  toolInputPartial: \"ui/notifications/tool-input-partial\",\n  toolInput: \"ui/notifications/tool-input\",\n  toolResult: \"ui/notifications/tool-result\",\n  // frame → host\n  ready: \"genframe/ready\",\n  initialize: \"ui/initialize\",\n  initialized: \"ui/notifications/initialized\",\n  sizeChanged: \"ui/notifications/size-changed\",\n  openLink: \"ui/open-link\",\n  message: \"ui/message\",\n  callTool: \"tools/call\",\n  requestDisplayMode: \"ui/request-display-mode\",\n  updateModelContext: \"ui/update-model-context\",\n  copyText: \"genframe/copy-text\",\n  widgetState: \"genframe/widget-state\",\n  log: \"genframe/log\",\n  error: \"genframe/error\",\n} as const;\n\nexport type WidgetKind = \"html\" | \"svg\";\n\nexport type ColorScheme = \"light\" | \"dark\";\n\nexport type DisplayMode = \"inline\" | \"fullscreen\" | \"pip\";\n\n/**\n * The params of a widget's MCP Apps `ui/initialize` request, as\n * `onInitialized` receives them. A malformed field is omitted, and\n * `availableDisplayModes` keeps only the modes in `DisplayMode`.\n */\nexport type McpAppInitializeParams = {\n  appInfo?: { name: string; version: string; [key: string]: unknown };\n  appCapabilities?: {\n    availableDisplayModes?: DisplayMode[];\n    [key: string]: unknown;\n  };\n  protocolVersion?: string;\n};\n\n/** The MCP Apps host context, plus the fields this package adds. */\nexport type HostContext = {\n  theme?: ColorScheme;\n  styles?: { variables?: Record<string, string> };\n  displayMode?: DisplayMode;\n  availableDisplayModes?: DisplayMode[];\n  locale?: string;\n  platform?: \"web\" | \"desktop\" | \"mobile\";\n  containerDimensions?: { width?: number; maxHeight?: number };\n  [key: string]: unknown;\n};\n\nexport type InitMessage = {\n  type: typeof INIT_MESSAGE;\n  context: HostContext;\n  state?: unknown;\n};\n\nexport type WidgetErrorKind =\n  | \"error\"\n  | \"unhandledrejection\"\n  | \"csp\"\n  | \"resource\"\n  | \"script\";\n\nexport type WidgetError = {\n  kind: WidgetErrorKind;\n  message: string;\n  source?: string;\n  line?: number;\n  column?: number;\n  stack?: string;\n};\n\nexport type ConsoleLevel = \"log\" | \"info\" | \"warn\" | \"error\" | \"debug\";\n\nexport type ConsoleEntry = {\n  level: ConsoleLevel;\n  message: string;\n};\n\nexport type WidgetSize = { width: number; height: number };\n\nexport type EndResult = {\n  size: WidgetSize;\n  blank: boolean;\n  errorCount: number;\n};\n\nexport type ClearStorageResult = {\n  /** The storage kinds that were cleared; a kind the browser lacks is left out. */\n  cleared: string[];\n};\n\nexport type FrameInspection = {\n  kind: WidgetKind;\n  ended: boolean;\n  size: WidgetSize;\n  blank: boolean;\n  errors: WidgetError[];\n  console: ConsoleEntry[];\n};\n\nexport type ScreenshotOptions = {\n  /** Device pixel ratio of the capture. Defaults to the frame's, capped at 2. */\n  scale?: number;\n  /** CSS color painted behind the widget. Defaults to `--color-background`. */\n  background?: string;\n};\n\nconst SVG_TAG = /^<svg[\\s>/]/i;\n\n/** Classifies widget code: SVG when it starts with an `<svg` element, otherwise HTML. */\nexport function detectWidgetKind(code: string): WidgetKind {\n  let rest = code.trimStart();\n  if (rest.startsWith(\"<?xml\")) {\n    const end = rest.indexOf(\">\");\n    if (end === -1) return \"html\";\n    rest = rest.slice(end + 1).trimStart();\n  }\n  while (rest.startsWith(\"<!--\")) {\n    const end = rest.indexOf(\"-->\", 4);\n    if (end === -1) return \"html\";\n    rest = rest.slice(end + 3).trimStart();\n  }\n  return SVG_TAG.test(rest) ? \"svg\" : \"html\";\n}\n"],"mappings":";AAAA,MAAa,4BAA4B;;AAGzC,MAAa,gBAAgB;AAC7B,MAAa,eAAe;AAE5B,MAAa,UAAU;CAErB,OAAO;CACP,KAAK;CACL,SAAS;CACT,YAAY;CACZ,SAAS;CACT,cAAc;CACd,oBAAoB;CACpB,kBAAkB;CAClB,WAAW;CACX,YAAY;CAEZ,OAAO;CACP,YAAY;CACZ,aAAa;CACb,aAAa;CACb,UAAU;CACV,SAAS;CACT,UAAU;CACV,oBAAoB;CACpB,oBAAoB;CACpB,UAAU;CACV,aAAa;CACb,KAAK;CACL,OAAO;AACT;AA4FA,MAAM,UAAU;;AAGhB,SAAgB,iBAAiB,MAA0B;CACzD,IAAI,OAAO,KAAK,UAAU;CAC1B,IAAI,KAAK,WAAW,OAAO,GAAG;EAC5B,MAAM,MAAM,KAAK,QAAQ,GAAG;EAC5B,IAAI,QAAQ,IAAI,OAAO;EACvB,OAAO,KAAK,MAAM,MAAM,CAAC,CAAC,CAAC,UAAU;CACvC;CACA,OAAO,KAAK,WAAW,MAAM,GAAG;EAC9B,MAAM,MAAM,KAAK,QAAQ,OAAO,CAAC;EACjC,IAAI,QAAQ,IAAI,OAAO;EACvB,OAAO,KAAK,MAAM,MAAM,CAAC,CAAC,CAAC,UAAU;CACvC;CACA,OAAO,QAAQ,KAAK,IAAI,IAAI,QAAQ;AACtC"}

package/dist/repair/repair.d.ts

@@ -0,0 +1,72 @@
+import type { ConsoleEntry, WidgetError } from "../protocol.js";
+import { type WidgetEdit } from "../tools/edits.js";
+/** What one render of a widget produced; `previewWidget` returns a compatible shape. */
+export type RenderReport = {
+    errors: WidgetError[];
+    console: ConsoleEntry[];
+    blank: boolean;
+    height?: number;
+    screenshot?: string;
+};
+export type RepairFeedback = {
+    ok: boolean;
+    round: number;
+    errors: WidgetError[];
+    /** Warnings and errors from the console, most recent last. */
+    console: ConsoleEntry[];
+    blank: boolean;
+    height?: number;
+    screenshot?: string;
+    /** The feedback as text for a tool result or follow-up message. */
+    text: string;
+};
+export type GenerateContext = {
+    round: number;
+    /** The code from the previous round; undefined in the first round. */
+    previousCode: string | undefined;
+    /** Feedback on the previous round; undefined in the first round. */
+    feedback: RepairFeedback | undefined;
+};
+/** Either complete new code or exact replacements on the previous round's code. */
+export type GenerateResult = string | {
+    edits: WidgetEdit[];
+};
+export type RepairRound = {
+    round: number;
+    code: string;
+    report: RenderReport;
+    feedback: RepairFeedback;
+};
+export type RepairLoopOptions = {
+    generate(context: GenerateContext): Promise<GenerateResult>;
+    render(code: string): Promise<RenderReport>;
+    /** Rounds including the first generation. Defaults to 3. */
+    maxRounds?: number;
+    /** Decides whether a render is good enough. Defaults to no errors and not blank. */
+    accept?(report: RenderReport): boolean;
+    /** Console entries carried into feedback. Defaults to 20. */
+    consoleLimit?: number;
+    /** Forward the screenshot to `generate`. Defaults to true. */
+    includeScreenshot?: boolean;
+};
+export type RepairLoopResult = {
+    ok: boolean;
+    code: string;
+    report: RenderReport;
+    rounds: RepairRound[];
+};
+/** Turns a render report into structured, model-readable feedback. */
+export declare function buildRepairFeedback(report: RenderReport, options?: {
+    round?: number;
+    ok?: boolean;
+    consoleLimit?: number;
+    includeScreenshot?: boolean;
+}): RepairFeedback;
+/**
+ * Generates a widget, renders it, and feeds structured feedback back into
+ * generation until a render is accepted or the round budget runs out. Returns
+ * the best attempt: the last accepted one, otherwise the one with the fewest
+ * errors.
+ */
+export declare function repairLoop(options: RepairLoopOptions): Promise<RepairLoopResult>;
+//# sourceMappingURL=repair.d.ts.map

package/dist/repair/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAa;AAC5D,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,mBAAgB;AAElE;AACA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,WAAW,EAAE;IACrB,OAAO,EAAE,YAAY,EAAE;IACvB,KAAK,EAAE,OAAO;IACd,MAAM,CAAC,EAAE,MAAM;IACf,UAAU,CAAC,EAAE,MAAM;CACpB;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,OAAO;IACX,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,WAAW,EAAE;IACrB;IACA,OAAO,EAAE,YAAY,EAAE;IACvB,KAAK,EAAE,OAAO;IACd,MAAM,CAAC,EAAE,MAAM;IACf,UAAU,CAAC,EAAE,MAAM;IACnB;IACA,IAAI,EAAE,MAAM;CACb;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM;IACb;IACA,YAAY,EAAE,MAAM,GAAG,SAAS;IAChC;IACA,QAAQ,EAAE,cAAc,GAAG,SAAS;CACrC;AAED;AACA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IAAE,KAAK,EAAE,UAAU,EAAE;CAAE;AAE7D,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,cAAc;CACzB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAC3D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C;IACA,SAAS,CAAC,EAAE,MAAM;IAClB;IACA,MAAM,CAAC,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IACtC;IACA,YAAY,CAAC,EAAE,MAAM;IACrB;IACA,iBAAiB,CAAC,EAAE,OAAO;CAC5B;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW,EAAE;CACtB;AAeD;AACA,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM;IACd,EAAE,CAAC,EAAE,OAAO;IACZ,YAAY,CAAC,EAAE,MAAM;IACrB,iBAAiB,CAAC,EAAE,OAAO;CACvB,GACL,cAAc;AAmDjB;;;;;;AAMA,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC","names":[],"ignoreList":[],"sources":["../../src/repair/repair.ts"],"sourcesContent":[null]}

package/dist/repair/repair.js

@@ -0,0 +1,103 @@
+import { applyWidgetEdits } from "../tools/edits.js";
+// src/repair/repair.ts
+const defaultAccept = (report) => report.errors.length === 0 && !report.blank;
+const describeError = (error) => {
+	const location = error.line !== void 0 ? ` (line ${error.line}${error.column !== void 0 ? `:${error.column}` : ""})` : "";
+	const source = error.source && error.kind !== "error" ? ` [${error.source}]` : "";
+	return `- ${error.kind}: ${error.message}${location}${source}`;
+};
+/** Turns a render report into structured, model-readable feedback. */
+function buildRepairFeedback(report, options = {}) {
+	const ok = options.ok ?? defaultAccept(report);
+	const consoleExcerpt = report.console.filter((entry) => entry.level === "warn" || entry.level === "error").slice(-(options.consoleLimit ?? 20));
+	const lines = [];
+	if (ok) lines.push("The widget rendered without errors.");
+	else lines.push("The widget did not render cleanly. Fix the causes below.");
+	if (report.errors.length > 0) lines.push("", `Errors (${report.errors.length}):`, ...report.errors.map(describeError));
+	if (report.blank) lines.push("", "The widget rendered blank: nothing visible ended up on screen. Check that content is not hidden, that script-drawn areas have an explicit height, and that scripts ran without errors.");
+	if (consoleExcerpt.length > 0) lines.push("", "Console:", ...consoleExcerpt.map((entry) => `- ${entry.level}: ${entry.message}`));
+	if (report.height !== void 0) lines.push("", `Rendered height: ${report.height}px.`);
+	const includeScreenshot = options.includeScreenshot ?? true;
+	return {
+		ok,
+		round: options.round ?? 1,
+		errors: report.errors,
+		console: consoleExcerpt,
+		blank: report.blank,
+		...report.height !== void 0 ? { height: report.height } : {},
+		...includeScreenshot && report.screenshot ? { screenshot: report.screenshot } : {},
+		text: lines.join("\n")
+	};
+}
+/**
+* Generates a widget, renders it, and feeds structured feedback back into
+* generation until a render is accepted or the round budget runs out. Returns
+* the best attempt: the last accepted one, otherwise the one with the fewest
+* errors.
+*/
+async function repairLoop(options) {
+	const maxRounds = Math.max(1, options.maxRounds ?? 3);
+	const accept = options.accept ?? defaultAccept;
+	const rounds = [];
+	let previousCode;
+	let feedback;
+	for (let round = 1; round <= maxRounds; round++) {
+		const generated = await options.generate({
+			round,
+			previousCode,
+			feedback
+		});
+		let code;
+		let report;
+		if (typeof generated === "string") {
+			code = generated;
+			report = await options.render(code);
+		} else {
+			const applied = applyWidgetEdits(previousCode ?? "", generated.edits);
+			if (applied.ok) {
+				code = applied.code;
+				report = await options.render(code);
+			} else {
+				code = previousCode ?? "";
+				report = {
+					errors: [{
+						kind: "error",
+						message: `Edits were not applied: ${applied.error}`
+					}],
+					console: [],
+					blank: false
+				};
+			}
+		}
+		const ok = accept(report);
+		feedback = buildRepairFeedback(report, {
+			round,
+			ok,
+			...options.consoleLimit !== void 0 ? { consoleLimit: options.consoleLimit } : {},
+			...options.includeScreenshot !== void 0 ? { includeScreenshot: options.includeScreenshot } : {}
+		});
+		rounds.push({
+			round,
+			code,
+			report,
+			feedback
+		});
+		previousCode = code;
+		if (ok) return {
+			ok: true,
+			code,
+			report,
+			rounds
+		};
+	}
+	const best = rounds.reduce((a, b) => b.report.errors.length + (b.report.blank ? 1 : 0) < a.report.errors.length + (a.report.blank ? 1 : 0) ? b : a);
+	return {
+		ok: false,
+		code: best.code,
+		report: best.report,
+		rounds
+	};
+}
+export { buildRepairFeedback, repairLoop };
+
+//# sourceMappingURL=repair.js.map

package/dist/repair/repair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.js","names":[],"sources":["../../src/repair/repair.ts"],"sourcesContent":["import type { ConsoleEntry, WidgetError } from \"../protocol\";\nimport { applyWidgetEdits, type WidgetEdit } from \"../tools/edits\";\n\n/** What one render of a widget produced; `previewWidget` returns a compatible shape. */\nexport type RenderReport = {\n  errors: WidgetError[];\n  console: ConsoleEntry[];\n  blank: boolean;\n  height?: number;\n  screenshot?: string;\n};\n\nexport type RepairFeedback = {\n  ok: boolean;\n  round: number;\n  errors: WidgetError[];\n  /** Warnings and errors from the console, most recent last. */\n  console: ConsoleEntry[];\n  blank: boolean;\n  height?: number;\n  screenshot?: string;\n  /** The feedback as text for a tool result or follow-up message. */\n  text: string;\n};\n\nexport type GenerateContext = {\n  round: number;\n  /** The code from the previous round; undefined in the first round. */\n  previousCode: string | undefined;\n  /** Feedback on the previous round; undefined in the first round. */\n  feedback: RepairFeedback | undefined;\n};\n\n/** Either complete new code or exact replacements on the previous round's code. */\nexport type GenerateResult = string | { edits: WidgetEdit[] };\n\nexport type RepairRound = {\n  round: number;\n  code: string;\n  report: RenderReport;\n  feedback: RepairFeedback;\n};\n\nexport type RepairLoopOptions = {\n  generate(context: GenerateContext): Promise<GenerateResult>;\n  render(code: string): Promise<RenderReport>;\n  /** Rounds including the first generation. Defaults to 3. */\n  maxRounds?: number;\n  /** Decides whether a render is good enough. Defaults to no errors and not blank. */\n  accept?(report: RenderReport): boolean;\n  /** Console entries carried into feedback. Defaults to 20. */\n  consoleLimit?: number;\n  /** Forward the screenshot to `generate`. Defaults to true. */\n  includeScreenshot?: boolean;\n};\n\nexport type RepairLoopResult = {\n  ok: boolean;\n  code: string;\n  report: RenderReport;\n  rounds: RepairRound[];\n};\n\nconst defaultAccept = (report: RenderReport) =>\n  report.errors.length === 0 && !report.blank;\n\nconst describeError = (error: WidgetError) => {\n  const location =\n    error.line !== undefined\n      ? ` (line ${error.line}${error.column !== undefined ? `:${error.column}` : \"\"})`\n      : \"\";\n  const source =\n    error.source && error.kind !== \"error\" ? ` [${error.source}]` : \"\";\n  return `- ${error.kind}: ${error.message}${location}${source}`;\n};\n\n/** Turns a render report into structured, model-readable feedback. */\nexport function buildRepairFeedback(\n  report: RenderReport,\n  options: {\n    round?: number;\n    ok?: boolean;\n    consoleLimit?: number;\n    includeScreenshot?: boolean;\n  } = {},\n): RepairFeedback {\n  const ok = options.ok ?? defaultAccept(report);\n  const consoleExcerpt = report.console\n    .filter((entry) => entry.level === \"warn\" || entry.level === \"error\")\n    .slice(-(options.consoleLimit ?? 20));\n\n  const lines: string[] = [];\n  if (ok) {\n    lines.push(\"The widget rendered without errors.\");\n  } else {\n    lines.push(\"The widget did not render cleanly. Fix the causes below.\");\n  }\n  if (report.errors.length > 0) {\n    lines.push(\n      \"\",\n      `Errors (${report.errors.length}):`,\n      ...report.errors.map(describeError),\n    );\n  }\n  if (report.blank) {\n    lines.push(\n      \"\",\n      \"The widget rendered blank: nothing visible ended up on screen. Check that content is not hidden, that script-drawn areas have an explicit height, and that scripts ran without errors.\",\n    );\n  }\n  if (consoleExcerpt.length > 0) {\n    lines.push(\n      \"\",\n      \"Console:\",\n      ...consoleExcerpt.map((entry) => `- ${entry.level}: ${entry.message}`),\n    );\n  }\n  if (report.height !== undefined) {\n    lines.push(\"\", `Rendered height: ${report.height}px.`);\n  }\n\n  const includeScreenshot = options.includeScreenshot ?? true;\n  return {\n    ok,\n    round: options.round ?? 1,\n    errors: report.errors,\n    console: consoleExcerpt,\n    blank: report.blank,\n    ...(report.height !== undefined ? { height: report.height } : {}),\n    ...(includeScreenshot && report.screenshot\n      ? { screenshot: report.screenshot }\n      : {}),\n    text: lines.join(\"\\n\"),\n  };\n}\n\n/**\n * Generates a widget, renders it, and feeds structured feedback back into\n * generation until a render is accepted or the round budget runs out. Returns\n * the best attempt: the last accepted one, otherwise the one with the fewest\n * errors.\n */\nexport async function repairLoop(\n  options: RepairLoopOptions,\n): Promise<RepairLoopResult> {\n  const maxRounds = Math.max(1, options.maxRounds ?? 3);\n  const accept = options.accept ?? defaultAccept;\n  const rounds: RepairRound[] = [];\n  let previousCode: string | undefined;\n  let feedback: RepairFeedback | undefined;\n\n  for (let round = 1; round <= maxRounds; round++) {\n    const generated = await options.generate({ round, previousCode, feedback });\n    let code: string;\n    let report: RenderReport;\n    if (typeof generated === \"string\") {\n      code = generated;\n      report = await options.render(code);\n    } else {\n      const applied = applyWidgetEdits(previousCode ?? \"\", generated.edits);\n      if (applied.ok) {\n        code = applied.code;\n        report = await options.render(code);\n      } else {\n        code = previousCode ?? \"\";\n        report = {\n          errors: [\n            {\n              kind: \"error\",\n              message: `Edits were not applied: ${applied.error}`,\n            },\n          ],\n          console: [],\n          blank: false,\n        };\n      }\n    }\n\n    const ok = accept(report);\n    feedback = buildRepairFeedback(report, {\n      round,\n      ok,\n      ...(options.consoleLimit !== undefined\n        ? { consoleLimit: options.consoleLimit }\n        : {}),\n      ...(options.includeScreenshot !== undefined\n        ? { includeScreenshot: options.includeScreenshot }\n        : {}),\n    });\n    rounds.push({ round, code, report, feedback });\n    previousCode = code;\n    if (ok) return { ok: true, code, report, rounds };\n  }\n\n  const best = rounds.reduce((a, b) =>\n    b.report.errors.length + (b.report.blank ? 1 : 0) <\n    a.report.errors.length + (a.report.blank ? 1 : 0)\n      ? b\n      : a,\n  );\n  return { ok: false, code: best.code, report: best.report, rounds };\n}\n"],"mappings":"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"}

package/dist/repair.d.ts

@@ -0,0 +1,2 @@
+export { repairLoop, buildRepairFeedback, type GenerateContext, type GenerateResult, type RenderReport, type RepairFeedback, type RepairLoopOptions, type RepairLoopResult, type RepairRound, } from "./repair/repair.js";
+//# sourceMappingURL=repair.d.ts.map

package/dist/repair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair.d.ts","mappings":"AAAA,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,WAAW,GACjB,MAAM,oBAAiB","names":[],"ignoreList":[],"sources":["../src/repair.ts"],"sourcesContent":[null]}

package/dist/repair.js

@@ -0,0 +1 @@
+export { buildRepairFeedback, repairLoop } from "./repair/repair.js";

package/dist/rpc.d.ts

@@ -0,0 +1,60 @@
+export type JsonRpcId = string | number;
+export type JsonRpcRequest = {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    method: string;
+    params?: unknown;
+};
+export type JsonRpcNotification = {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+};
+export type JsonRpcResponse = {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+};
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcResponse;
+export declare const RPC_ERROR: {
+    readonly parseError: -32700;
+    readonly invalidRequest: -32600;
+    readonly methodNotFound: -32601;
+    readonly invalidParams: -32602;
+    readonly internalError: -32603;
+};
+export declare class RpcError extends Error {
+    readonly code: number;
+    readonly data: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+/** The subset of `MessagePort` the peer uses. */
+export type RpcEndpoint = {
+    postMessage(message: unknown): void;
+    addEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    removeEventListener(type: "message", listener: (event: MessageEvent) => void): void;
+    start?(): void;
+};
+export type RpcHandlers = {
+    /** Resolves to the result; throw an `RpcError` to answer with a specific code. */
+    onRequest?: (method: string, params: unknown) => unknown;
+    onNotification?: (method: string, params: unknown) => void;
+};
+export type RpcPeer = {
+    request(method: string, params?: unknown, options?: {
+        timeoutMs?: number;
+    }): Promise<unknown>;
+    notify(method: string, params?: unknown): void;
+    /** Feeds a message received outside the endpoint, such as a window message. */
+    receive(message: unknown, reply?: (message: JsonRpcMessage) => void): void;
+    dispose(): void;
+};
+export declare function isJsonRpcMessage(value: unknown): value is JsonRpcMessage;
+/** A symmetric JSON-RPC 2.0 peer: both sides can send requests and notifications. */
+export declare function createRpcPeer(endpoint: RpcEndpoint, handlers?: RpcHandlers): RpcPeer;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM;AAEvC,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,KAAK;IACd,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,MAAM;IACd,MAAM,CAAC,EAAE,OAAO;CACjB;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,KAAK;IACd,MAAM,EAAE,MAAM;IACd,MAAM,CAAC,EAAE,OAAO;CACjB;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,KAAK;IACd,EAAE,EAAE,SAAS;IACb,MAAM,CAAC,EAAE,OAAO;IAChB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM;QAAE,OAAO,EAAE,MAAM;QAAE,IAAI,CAAC,EAAE,OAAO;KAAE;CAC1D;AAED,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,mBAAmB,GACnB,eAAe;AAEnB,eAAO,MAAM,SAAS;;;;;;CAMZ;AAEV,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;;AAQ3D;AACA,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IACnC,gBAAgB,CACd,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACtC,IAAI;IACP,mBAAmB,CACjB,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACtC,IAAI;IACP,KAAK,CAAC,IAAI,IAAI;CACf;AAED,MAAM,MAAM,WAAW,GAAG;IACxB;IACA,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO;IACxD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI;CAC3D;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,OAAO,CACL,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM;KAAE,GAC/B,OAAO,CAAC,OAAO,CAAC;IACnB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAC9C;IACA,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAC1E,OAAO,IAAI,IAAI;CAChB;AAKD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc;AAkBzE;AACA,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EACrB,QAAQ,GAAE,WAAgB,GACzB,OAAO","names":[],"ignoreList":[],"sources":["../src/rpc.ts"],"sourcesContent":[null]}

package/dist/rpc.js

@@ -0,0 +1,127 @@
+// src/rpc.ts
+const RPC_ERROR = {
+	parseError: -32700,
+	invalidRequest: -32600,
+	methodNotFound: -32601,
+	invalidParams: -32602,
+	internalError: -32603
+};
+var RpcError = class extends Error {
+	code;
+	data;
+	constructor(code, message, data) {
+		super(message);
+		this.name = "RpcError";
+		this.code = code;
+		this.data = data;
+	}
+};
+const isRecord = (value) => typeof value === "object" && value !== null;
+function isJsonRpcMessage(value) {
+	return isRecord(value) && value["jsonrpc"] === "2.0";
+}
+const errorPayload = (error) => {
+	if (error instanceof RpcError) return {
+		code: error.code,
+		message: error.message,
+		...error.data !== void 0 ? { data: error.data } : {}
+	};
+	return {
+		code: RPC_ERROR.internalError,
+		message: error instanceof Error ? error.message : String(error)
+	};
+};
+/** A symmetric JSON-RPC 2.0 peer: both sides can send requests and notifications. */
+function createRpcPeer(endpoint, handlers = {}) {
+	let nextId = 1;
+	let disposed = false;
+	const pending = /* @__PURE__ */ new Map();
+	const post = (message) => {
+		if (disposed) return;
+		endpoint.postMessage(message);
+	};
+	const handleRequest = async (request, reply) => {
+		try {
+			if (!handlers.onRequest) throw new RpcError(RPC_ERROR.methodNotFound, `Unknown method: ${request.method}`);
+			const result = await handlers.onRequest(request.method, request.params);
+			reply({
+				jsonrpc: "2.0",
+				id: request.id,
+				result: result ?? null
+			});
+		} catch (error) {
+			reply({
+				jsonrpc: "2.0",
+				id: request.id,
+				error: errorPayload(error)
+			});
+		}
+	};
+	const receive = (message, reply = post) => {
+		if (disposed || !isJsonRpcMessage(message)) return;
+		const hasId = "id" in message && (typeof message.id === "string" || typeof message.id === "number");
+		if ("method" in message && typeof message.method === "string") {
+			if (hasId) handleRequest(message, reply);
+			else try {
+				handlers.onNotification?.(message.method, message.params);
+			} catch {}
+			return;
+		}
+		if (!hasId) return;
+		const response = message;
+		const entry = pending.get(response.id);
+		if (!entry) return;
+		pending.delete(response.id);
+		if (entry.timer !== void 0) clearTimeout(entry.timer);
+		if (response.error) entry.reject(new RpcError(response.error.code, response.error.message, response.error.data));
+		else entry.resolve(response.result);
+	};
+	const onMessage = (event) => receive(event.data);
+	endpoint.addEventListener("message", onMessage);
+	endpoint.start?.();
+	return {
+		request(method, params, options) {
+			if (disposed) return Promise.reject(/* @__PURE__ */ new Error("RPC peer is disposed"));
+			const id = nextId++;
+			return new Promise((resolve, reject) => {
+				const timeoutMs = options?.timeoutMs;
+				const timer = timeoutMs === void 0 ? void 0 : setTimeout(() => {
+					pending.delete(id);
+					reject(/* @__PURE__ */ new Error(`${method} timed out after ${timeoutMs}ms`));
+				}, timeoutMs);
+				pending.set(id, {
+					resolve,
+					reject,
+					timer
+				});
+				post({
+					jsonrpc: "2.0",
+					id,
+					method,
+					...params !== void 0 ? { params } : {}
+				});
+			});
+		},
+		notify(method, params) {
+			post({
+				jsonrpc: "2.0",
+				method,
+				...params !== void 0 ? { params } : {}
+			});
+		},
+		receive,
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			endpoint.removeEventListener("message", onMessage);
+			for (const entry of pending.values()) {
+				if (entry.timer !== void 0) clearTimeout(entry.timer);
+				entry.reject(/* @__PURE__ */ new Error("RPC peer is disposed"));
+			}
+			pending.clear();
+		}
+	};
+}
+export { RPC_ERROR, RpcError, createRpcPeer, isJsonRpcMessage };
+
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","names":[],"sources":["../src/rpc.ts"],"sourcesContent":["export type JsonRpcId = string | number;\n\nexport type JsonRpcRequest = {\n  jsonrpc: \"2.0\";\n  id: JsonRpcId;\n  method: string;\n  params?: unknown;\n};\n\nexport type JsonRpcNotification = {\n  jsonrpc: \"2.0\";\n  method: string;\n  params?: unknown;\n};\n\nexport type JsonRpcResponse = {\n  jsonrpc: \"2.0\";\n  id: JsonRpcId;\n  result?: unknown;\n  error?: { code: number; message: string; data?: unknown };\n};\n\nexport type JsonRpcMessage =\n  | JsonRpcRequest\n  | JsonRpcNotification\n  | JsonRpcResponse;\n\nexport const RPC_ERROR = {\n  parseError: -32700,\n  invalidRequest: -32600,\n  methodNotFound: -32601,\n  invalidParams: -32602,\n  internalError: -32603,\n} as const;\n\nexport class RpcError extends Error {\n  readonly code: number;\n  readonly data: unknown;\n\n  constructor(code: number, message: string, data?: unknown) {\n    super(message);\n    this.name = \"RpcError\";\n    this.code = code;\n    this.data = data;\n  }\n}\n\n/** The subset of `MessagePort` the peer uses. */\nexport type RpcEndpoint = {\n  postMessage(message: unknown): void;\n  addEventListener(\n    type: \"message\",\n    listener: (event: MessageEvent) => void,\n  ): void;\n  removeEventListener(\n    type: \"message\",\n    listener: (event: MessageEvent) => void,\n  ): void;\n  start?(): void;\n};\n\nexport type RpcHandlers = {\n  /** Resolves to the result; throw an `RpcError` to answer with a specific code. */\n  onRequest?: (method: string, params: unknown) => unknown;\n  onNotification?: (method: string, params: unknown) => void;\n};\n\nexport type RpcPeer = {\n  request(\n    method: string,\n    params?: unknown,\n    options?: { timeoutMs?: number },\n  ): Promise<unknown>;\n  notify(method: string, params?: unknown): void;\n  /** Feeds a message received outside the endpoint, such as a window message. */\n  receive(message: unknown, reply?: (message: JsonRpcMessage) => void): void;\n  dispose(): void;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null;\n\nexport function isJsonRpcMessage(value: unknown): value is JsonRpcMessage {\n  return isRecord(value) && value[\"jsonrpc\"] === \"2.0\";\n}\n\nconst errorPayload = (error: unknown) => {\n  if (error instanceof RpcError) {\n    return {\n      code: error.code,\n      message: error.message,\n      ...(error.data !== undefined ? { data: error.data } : {}),\n    };\n  }\n  return {\n    code: RPC_ERROR.internalError,\n    message: error instanceof Error ? error.message : String(error),\n  };\n};\n\n/** A symmetric JSON-RPC 2.0 peer: both sides can send requests and notifications. */\nexport function createRpcPeer(\n  endpoint: RpcEndpoint,\n  handlers: RpcHandlers = {},\n): RpcPeer {\n  let nextId = 1;\n  let disposed = false;\n  const pending = new Map<\n    JsonRpcId,\n    {\n      resolve: (value: unknown) => void;\n      reject: (error: unknown) => void;\n      timer: ReturnType<typeof setTimeout> | undefined;\n    }\n  >();\n\n  const post = (message: JsonRpcMessage) => {\n    if (disposed) return;\n    endpoint.postMessage(message);\n  };\n\n  const handleRequest = async (\n    request: JsonRpcRequest,\n    reply: (message: JsonRpcMessage) => void,\n  ) => {\n    try {\n      if (!handlers.onRequest) {\n        throw new RpcError(\n          RPC_ERROR.methodNotFound,\n          `Unknown method: ${request.method}`,\n        );\n      }\n      const result = await handlers.onRequest(request.method, request.params);\n      reply({ jsonrpc: \"2.0\", id: request.id, result: result ?? null });\n    } catch (error) {\n      reply({ jsonrpc: \"2.0\", id: request.id, error: errorPayload(error) });\n    }\n  };\n\n  const receive = (\n    message: unknown,\n    reply: (message: JsonRpcMessage) => void = post,\n  ) => {\n    if (disposed || !isJsonRpcMessage(message)) return;\n    const hasId =\n      \"id\" in message &&\n      (typeof message.id === \"string\" || typeof message.id === \"number\");\n\n    if (\"method\" in message && typeof message.method === \"string\") {\n      if (hasId) {\n        void handleRequest(message as JsonRpcRequest, reply);\n      } else {\n        try {\n          handlers.onNotification?.(message.method, message.params);\n        } catch {\n          // A failing notification handler has nobody to answer to.\n        }\n      }\n      return;\n    }\n\n    if (!hasId) return;\n    const response = message as JsonRpcResponse;\n    const entry = pending.get(response.id);\n    if (!entry) return;\n    pending.delete(response.id);\n    if (entry.timer !== undefined) clearTimeout(entry.timer);\n    if (response.error) {\n      entry.reject(\n        new RpcError(\n          response.error.code,\n          response.error.message,\n          response.error.data,\n        ),\n      );\n    } else {\n      entry.resolve(response.result);\n    }\n  };\n\n  const onMessage = (event: MessageEvent) => receive(event.data);\n  endpoint.addEventListener(\"message\", onMessage);\n  endpoint.start?.();\n\n  return {\n    request(method, params, options) {\n      if (disposed) {\n        return Promise.reject(new Error(\"RPC peer is disposed\"));\n      }\n      const id = nextId++;\n      return new Promise((resolve, reject) => {\n        const timeoutMs = options?.timeoutMs;\n        const timer =\n          timeoutMs === undefined\n            ? undefined\n            : setTimeout(() => {\n                pending.delete(id);\n                reject(new Error(`${method} timed out after ${timeoutMs}ms`));\n              }, timeoutMs);\n        pending.set(id, { resolve, reject, timer });\n        post({\n          jsonrpc: \"2.0\",\n          id,\n          method,\n          ...(params !== undefined ? { params } : {}),\n        });\n      });\n    },\n    notify(method, params) {\n      post({\n        jsonrpc: \"2.0\",\n        method,\n        ...(params !== undefined ? { params } : {}),\n      });\n    },\n    receive,\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      endpoint.removeEventListener(\"message\", onMessage);\n      for (const entry of pending.values()) {\n        if (entry.timer !== undefined) clearTimeout(entry.timer);\n        entry.reject(new Error(\"RPC peer is disposed\"));\n      }\n      pending.clear();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/runtime/diagnostics.d.ts

@@ -0,0 +1,17 @@
+import type { ConsoleEntry, WidgetError } from "../protocol.js";
+export declare const formatValue: (value: unknown) => string;
+export type Diagnostics = {
+    readonly errors: WidgetError[];
+    readonly console: ConsoleEntry[];
+    record(error: WidgetError): void;
+    dispose(): void;
+};
+export type DiagnosticsOptions = {
+    onError?: (error: WidgetError) => void;
+    onConsole?: (entry: ConsoleEntry) => void;
+};
+/** Captures errors, console output, failed resources, and CSP violations in a window. */
+export declare function installDiagnostics(win: Window & typeof globalThis, options?: DiagnosticsOptions): Diagnostics;
+/** True when the widget rendered nothing a person could see. */
+export declare function isBlankRender(root: HTMLElement): boolean;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/runtime/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAgB,WAAW,EAAE,MAAM,gBAAa;AAiB1E,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAe5C;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE;IAC9B,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE;IAChC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAChC,OAAO,IAAI,IAAI;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IACtC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI;CAC1C;AAED;AACA,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GAAG,OAAO,UAAU,EAC/B,OAAO,GAAE,kBAAuB,GAC/B,WAAW;AA4Fd;AACA,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO","names":[],"ignoreList":[],"sources":["../../src/runtime/diagnostics.ts"],"sourcesContent":[null]}

package/dist/runtime/diagnostics.js

@@ -0,0 +1,128 @@
+// src/runtime/diagnostics.ts
+const MAX_CONSOLE = 200;
+const MAX_ERRORS = 50;
+const MAX_MESSAGE = 1e3;
+const LEVELS = [
+	"log",
+	"info",
+	"warn",
+	"error",
+	"debug"
+];
+const truncate = (text) => text.length > MAX_MESSAGE ? `${text.slice(0, MAX_MESSAGE)}…` : text;
+const formatValue = (value) => {
+	if (typeof value === "string") return value;
+	if (value instanceof Error) return value.stack ?? `${value.name}: ${value.message}`;
+	if (typeof value === "object" && value !== null) {
+		if (typeof Node !== "undefined" && value instanceof Node) return `<${value.nodeName.toLowerCase()}>`;
+		try {
+			return JSON.stringify(value);
+		} catch {
+			return String(value);
+		}
+	}
+	return String(value);
+};
+/** Captures errors, console output, failed resources, and CSP violations in a window. */
+function installDiagnostics(win, options = {}) {
+	const errors = [];
+	const consoleEntries = [];
+	const record = (error) => {
+		const normalized = {
+			...error,
+			message: truncate(error.message)
+		};
+		if (errors.length < MAX_ERRORS) errors.push(normalized);
+		options.onError?.(normalized);
+	};
+	const onError = (event) => {
+		const target = event.target;
+		if (target && target !== win && target instanceof win.Element) {
+			const src = target.getAttribute("src") ?? target.getAttribute("href") ?? void 0;
+			record({
+				kind: "resource",
+				message: `Failed to load <${target.localName}>${src ? ` ${src}` : ""}`,
+				...src ? { source: src } : {}
+			});
+			return;
+		}
+		const e = event;
+		const stack = e.error instanceof Error ? e.error.stack : void 0;
+		record({
+			kind: "error",
+			message: e.message || formatValue(e.error),
+			...e.filename ? { source: e.filename } : {},
+			...e.lineno ? { line: e.lineno } : {},
+			...e.colno ? { column: e.colno } : {},
+			...stack ? { stack: truncate(stack) } : {}
+		});
+	};
+	const onRejection = (event) => {
+		const reason = event.reason;
+		const stack = reason instanceof Error ? reason.stack : void 0;
+		record({
+			kind: "unhandledrejection",
+			message: reason instanceof Error ? reason.message : formatValue(reason),
+			...stack ? { stack: truncate(stack) } : {}
+		});
+	};
+	const onViolation = (event) => {
+		record({
+			kind: "csp",
+			message: `Blocked by Content Security Policy (${event.effectiveDirective}): ${event.blockedURI || "inline"}`,
+			...event.blockedURI ? { source: event.blockedURI } : {},
+			...event.lineNumber ? { line: event.lineNumber } : {}
+		});
+	};
+	win.addEventListener("error", onError, true);
+	win.addEventListener("unhandledrejection", onRejection);
+	win.document.addEventListener("securitypolicyviolation", onViolation);
+	const originals = /* @__PURE__ */ new Map();
+	for (const level of LEVELS) {
+		const original = win.console[level];
+		originals.set(level, original);
+		win.console[level] = (...args) => {
+			const entry = {
+				level,
+				message: truncate(args.map(formatValue).join(" "))
+			};
+			consoleEntries.push(entry);
+			if (consoleEntries.length > MAX_CONSOLE) consoleEntries.shift();
+			options.onConsole?.(entry);
+			original.apply(win.console, args);
+		};
+	}
+	return {
+		errors,
+		console: consoleEntries,
+		record,
+		dispose() {
+			win.removeEventListener("error", onError, true);
+			win.removeEventListener("unhandledrejection", onRejection);
+			win.document.removeEventListener("securitypolicyviolation", onViolation);
+			for (const [level, original] of originals) win.console[level] = original;
+		}
+	};
+}
+const VISUAL_SELECTOR = "svg, canvas, img, video, picture, iframe, input, button, select, textarea, progress, meter";
+/** True when the widget rendered nothing a person could see. */
+function isBlankRender(root) {
+	const rect = root.getBoundingClientRect();
+	if (rect.height < 2 || rect.width < 2) return true;
+	if ((root.textContent ?? "").trim().length > 0) return false;
+	for (const el of Array.from(root.querySelectorAll(VISUAL_SELECTOR))) {
+		const r = el.getBoundingClientRect();
+		if (r.width >= 2 && r.height >= 2) return false;
+	}
+	for (const el of Array.from(root.querySelectorAll("*"))) {
+		const style = root.ownerDocument.defaultView?.getComputedStyle(el);
+		if (!style) continue;
+		if (!(style.backgroundColor !== "rgba(0, 0, 0, 0)" && style.backgroundColor !== "transparent" || style.backgroundImage !== "none" || parseFloat(style.borderTopWidth) > 0)) continue;
+		const r = el.getBoundingClientRect();
+		if (r.width >= 2 && r.height >= 2) return false;
+	}
+	return true;
+}
+export { formatValue, installDiagnostics, isBlankRender };
+
+//# sourceMappingURL=diagnostics.js.map