@flanksource/clicky-ui 0.3.55 → 0.3.57

package/dist/file-findings/AnnotatedCode.js

@@ -0,0 +1,243 @@
+import { cn } from "../lib/utils.js";
+import { ProblemActions } from "../data/diagnostics/ProblemActions.js";
+import { severityRank } from "../data/lint/stats.js";
+import { useCommentContext } from "../comments/comment-context.js";
+import { CommentProvider } from "../comments/CommentProvider.js";
+import { CommentSidePanel } from "../comments/CommentSidePanel.js";
+import { MonacoEditor } from "../monaco/MonacoEditor.js";
+import { FINDINGS_COMMENT_CONFIG, findingsToComments, lineAnchor, lineOfAnchor, lineRangeAnchorResolver } from "./findings-comments.js";
+import { findingsLanguageForPath } from "./monaco-language.js";
+import { registerFindingsLanguages } from "./findings-languages.js";
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+// src/file-findings/AnnotatedCode.tsx
+var MARKER_OWNER = "findings";
+var LINE_TINT = {
+	error: "bg-red-500 opacity-10",
+	warning: "bg-amber-500 opacity-10",
+	info: "bg-sky-500 opacity-10"
+};
+var GLYPH_BASE = "ml-1 mt-1 size-3 rounded-full";
+var GLYPH = {
+	error: `${GLYPH_BASE} bg-red-500`,
+	warning: `${GLYPH_BASE} bg-amber-500`,
+	info: `${GLYPH_BASE} bg-sky-500`
+};
+var CHIP_BASE = "ml-6 italic";
+var CHIP = {
+	error: `${CHIP_BASE} text-red-500`,
+	warning: `${CHIP_BASE} text-amber-500`,
+	info: `${CHIP_BASE} text-sky-500`
+};
+function markerSeverity(monaco, severity) {
+	const { MarkerSeverity } = monaco;
+	return {
+		error: MarkerSeverity.Error,
+		warning: MarkerSeverity.Warning,
+		info: MarkerSeverity.Info
+	}[severity];
+}
+function modelPath(workDir, file) {
+	return encodeURI(`file://${workDir ? workDir.startsWith("/") ? workDir : `/${workDir}` : ""}/${file}`);
+}
+/** The editor-model markers for `findings`: the finding's range when it has one, else the rest of its line. */
+function toMarkers(findings, model, monaco) {
+	return findings.map((finding) => {
+		const endLineNumber = finding.endLine ?? finding.line;
+		return {
+			severity: markerSeverity(monaco, finding.severity),
+			message: finding.message,
+			source: finding.source,
+			...finding.rule ? { code: finding.rule } : {},
+			startLineNumber: finding.line,
+			startColumn: finding.column ?? 1,
+			endLineNumber,
+			endColumn: finding.endColumn ?? model.getLineMaxColumn(endLineNumber)
+		};
+	});
+}
+/**
+* One chip per line that has findings: the worst finding's `rule · message`,
+* with `+N` for the line's other findings, injected after the line's text.
+*/
+function inlineChipDecorations(findings, model) {
+	const byLine = /* @__PURE__ */ new Map();
+	for (const finding of findings) byLine.set(finding.line, [...byLine.get(finding.line) ?? [], finding]);
+	return [...byLine].map(([line, onLine]) => {
+		const worst = onLine.reduce((a, b) => severityRank(b.severity) > severityRank(a.severity) ? b : a);
+		const label = worst.rule ? `${worst.rule} · ${worst.message}` : worst.message;
+		const column = model.getLineMaxColumn(line);
+		return {
+			range: {
+				startLineNumber: line,
+				startColumn: column,
+				endLineNumber: line,
+				endColumn: column
+			},
+			options: {
+				showIfCollapsed: true,
+				after: {
+					content: onLine.length > 1 ? `${label} +${onLine.length - 1}` : label,
+					inlineClassName: CHIP[worst.severity]
+				}
+			}
+		};
+	});
+}
+/** The first finding whose line range covers `line`. */
+function findingCovering(findings, line) {
+	return findings.find((f) => f.line <= line && line <= (f.endLine ?? f.line));
+}
+function CodeBody({ mounted, onMount, contentElement, path, workDir, source, findings, line, onLineChange, getFindingActions, onChange, inlineChips, className }) {
+	const ctx = useCommentContext();
+	const { focusAnchor, commentMeta } = ctx;
+	const findingsById = useMemo(() => {
+		const comments = findingsToComments(findings);
+		return new Map(comments.map((comment, i) => [comment.id, findings[i]]));
+	}, [findings]);
+	useEffect(() => {
+		if (!mounted) return;
+		const { editor, monaco } = mounted;
+		const model = editor.getModel();
+		if (!model) return;
+		editor.updateOptions({ glyphMargin: true });
+		monaco.editor.setModelMarkers(model, MARKER_OWNER, toMarkers(findings, model, monaco));
+		const decorations = editor.createDecorationsCollection([...findings.map((finding) => ({
+			range: {
+				startLineNumber: finding.line,
+				startColumn: 1,
+				endLineNumber: finding.endLine ?? finding.line,
+				endColumn: 1
+			},
+			options: {
+				isWholeLine: true,
+				className: LINE_TINT[finding.severity],
+				glyphMarginClassName: GLYPH[finding.severity],
+				glyphMarginHoverMessage: { value: finding.message }
+			}
+		})), ...inlineChips ? inlineChipDecorations(findings, model) : []]);
+		return () => {
+			decorations.clear();
+			monaco.editor.setModelMarkers(model, MARKER_OWNER, []);
+		};
+	}, [
+		mounted,
+		findings,
+		inlineChips
+	]);
+	useEffect(() => {
+		if (!mounted) return;
+		const { editor } = mounted;
+		const subscription = editor.onMouseDown((event) => {
+			const clicked = event.target.position?.lineNumber;
+			const finding = clicked === void 0 ? void 0 : findingCovering(findings, clicked);
+			if (!finding) return;
+			focusAnchor(lineAnchor(finding.line));
+			onLineChange?.(finding.line);
+		});
+		return () => subscription.dispose();
+	}, [
+		mounted,
+		findings,
+		focusAnchor,
+		onLineChange
+	]);
+	useEffect(() => {
+		const element = contentElement.current;
+		if (!mounted || !element) return;
+		const notify = () => element.dispatchEvent(new Event("scroll"));
+		const subscription = mounted.editor.onDidScrollChange(notify);
+		notify();
+		return () => subscription.dispose();
+	}, [mounted, contentElement]);
+	useLayoutEffect(() => {
+		if (!mounted || line === void 0) return;
+		mounted.editor.revealLineInCenter(line);
+		if (commentMeta[lineAnchor(line)]) focusAnchor(lineAnchor(line));
+	}, [
+		mounted,
+		line,
+		focusAnchor
+	]);
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("flex h-full min-h-0", className),
+		"data-annotated-code": "",
+		children: [/* @__PURE__ */ jsx("div", {
+			ref: (element) => {
+				ctx.contentRef.current = element;
+				contentElement.current = element;
+			},
+			className: "min-w-0 flex-1 [&_[data-slot=monaco-editor]]:h-full [&_[data-slot=monaco-editor]]:rounded-none [&_[data-slot=monaco-editor]]:border-0",
+			children: /* @__PURE__ */ jsx(MonacoEditor, {
+				...onChange ? { onChange } : { readOnly: true },
+				value: source,
+				language: findingsLanguageForPath(path),
+				path: modelPath(workDir, path),
+				height: "100%",
+				beforeMount: (monaco) => registerFindingsLanguages(monaco.languages),
+				onMount: (editor, monaco) => onMount({
+					editor,
+					monaco
+				})
+			})
+		}), /* @__PURE__ */ jsx("div", {
+			className: "shrink-0 overflow-y-auto border-l border-border px-density-3",
+			children: /* @__PURE__ */ jsx(CommentSidePanel, {
+				focusedAlignment: "anchor",
+				formatAnchorLabel: (anchor) => `line ${lineOfAnchor(anchor)}`,
+				renderRootDetails: (comment) => {
+					const finding = findingsById.get(comment.id);
+					return finding && getFindingActions ? /* @__PURE__ */ jsx(ProblemActions, { items: getFindingActions(finding) }) : null;
+				}
+			})
+		})]
+	});
+}
+/**
+* A source file in a Monaco editor with its findings as markers, as gutter
+* dots and as read-only comment threads in a rail beside it. The editor is
+* read-only unless `onChange` is given. Needs a
+* `MonacoProvider` above it. The rail and the editor share one anchor scheme
+* (`line:<n>`): the rail asks the editor where a line is and tells it to
+* reveal one.
+*/
+function AnnotatedCode({ findings, ...props }) {
+	const [mounted, setMounted] = useState(null);
+	const contentElement = useRef(null);
+	const comments = useMemo(() => findingsToComments(findings), [findings]);
+	const getAnchorTop = useCallback((anchor) => {
+		const container = contentElement.current;
+		const model = mounted?.editor.getModel();
+		const dom = mounted?.editor.getDomNode();
+		if (!mounted || !container || !model || !dom) return null;
+		const line = lineOfAnchor(anchor);
+		if (line > model.getLineCount()) return null;
+		return dom.getBoundingClientRect().top - container.getBoundingClientRect().top + mounted.editor.getTopForLineNumber(line) - mounted.editor.getScrollTop();
+	}, [mounted]);
+	const onScrollToAnchor = useCallback((anchor, options) => {
+		if (!mounted) return false;
+		const { editor, monaco } = mounted;
+		const line = lineOfAnchor(anchor);
+		if (line > (editor.getModel()?.getLineCount() ?? 0)) return false;
+		editor.revealLineInCenter(line, options.behavior === "smooth" ? monaco.editor.ScrollType.Smooth : monaco.editor.ScrollType.Immediate);
+		return true;
+	}, [mounted]);
+	return /* @__PURE__ */ jsx(CommentProvider, {
+		comments,
+		config: FINDINGS_COMMENT_CONFIG,
+		resolveAnchor: lineRangeAnchorResolver,
+		getAnchorTop,
+		onScrollToAnchor,
+		initialRailMode: "all",
+		children: /* @__PURE__ */ jsx(CodeBody, {
+			mounted,
+			onMount: setMounted,
+			contentElement,
+			findings,
+			...props
+		})
+	});
+}
+export { AnnotatedCode };
+
+//# sourceMappingURL=AnnotatedCode.js.map

package/dist/file-findings/AnnotatedCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnnotatedCode.js","names":[],"sources":["../../src/file-findings/AnnotatedCode.tsx"],"sourcesContent":["import type { DropdownMenuItem } from \"../overlay/DropdownMenu\";\nimport { ProblemActions } from \"../data/diagnostics/ProblemActions\";\nimport type { editor as MonacoEditorApi, IDisposable } from \"monaco-editor\";\nimport { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from \"react\";\nimport { CommentProvider } from \"../comments/CommentProvider\";\nimport { CommentSidePanel } from \"../comments/CommentSidePanel\";\nimport { useCommentContext } from \"../comments/comment-context\";\nimport type { CommentScrollOptions } from \"../comments/comment-context\";\nimport type { CommentAnchor } from \"../comments/comment-types\";\nimport { severityRank } from \"../data/lint/stats\";\nimport { cn } from \"../lib/utils\";\nimport type { Monaco } from \"../monaco\";\nimport { MonacoEditor } from \"../monaco/MonacoEditor\";\nimport {\n  FINDINGS_COMMENT_CONFIG,\n  findingsToComments,\n  lineAnchor,\n  lineOfAnchor,\n  lineRangeAnchorResolver,\n} from \"./findings-comments\";\nimport { registerFindingsLanguages } from \"./findings-languages\";\nimport { findingsLanguageForPath } from \"./monaco-language\";\nimport type { FileFinding, LintSeverity } from \"./types\";\n\nexport type AnnotatedCodeProps = {\n  /** Path of the file; picks the language and names the editor model. */\n  path: string;\n  workDir?: string | undefined;\n  source: string;\n  findings: readonly FileFinding[];\n  /** Line to reveal and, when a finding starts on it, to focus. Controlled by the host. */\n  line?: number | undefined;\n  /** Called with a finding's first line when the reader clicks a line it covers. */\n  onLineChange?: ((line: number) => void) | undefined;\n  /** Extra controls under each finding's thread, e.g. an ignore action. */\n  getFindingActions?: ((finding: FileFinding) => DropdownMenuItem[]) | undefined;\n  /** Makes the editor editable and receives every edit; without it the editor is read-only. */\n  onChange?: ((source: string) => void) | undefined;\n  /** Shows each line's worst finding as `rule · message` after the line's text. */\n  inlineChips?: boolean | undefined;\n  className?: string | undefined;\n};\n\ntype MountedEditor = { editor: MonacoEditorApi.IStandaloneCodeEditor; monaco: Monaco };\n\nconst MARKER_OWNER = \"findings\";\n\n// Tailwind utilities, so the library's own stylesheet scan emits them; Monaco\n// only applies the class names to its decoration elements. Monaco replaces\n// every character outside [a-zA-Z0-9_-] in a decoration class with a space,\n// so none of these may use `/`, `.`, `[` or `:` (no `bg-red-500/10`, `px-1.5`\n// or `ml-[5px]`). The tint is a text-free overlay, so `opacity-10` stands in\n// for an alpha background.\nconst LINE_TINT: Record<LintSeverity, string> = {\n  error: \"bg-red-500 opacity-10\",\n  warning: \"bg-amber-500 opacity-10\",\n  info: \"bg-sky-500 opacity-10\",\n};\nconst GLYPH_BASE = \"ml-1 mt-1 size-3 rounded-full\";\nconst GLYPH: Record<LintSeverity, string> = {\n  error: `${GLYPH_BASE} bg-red-500`,\n  warning: `${GLYPH_BASE} bg-amber-500`,\n  info: `${GLYPH_BASE} bg-sky-500`,\n};\nconst CHIP_BASE = \"ml-6 italic\";\nconst CHIP: Record<LintSeverity, string> = {\n  error: `${CHIP_BASE} text-red-500`,\n  warning: `${CHIP_BASE} text-amber-500`,\n  info: `${CHIP_BASE} text-sky-500`,\n};\n\nfunction markerSeverity(monaco: Monaco, severity: LintSeverity): number {\n  const { MarkerSeverity } = monaco;\n  return { error: MarkerSeverity.Error, warning: MarkerSeverity.Warning, info: MarkerSeverity.Info }[severity];\n}\n\nfunction modelPath(workDir: string | undefined, file: string): string {\n  return encodeURI(`file://${workDir ? (workDir.startsWith(\"/\") ? workDir : `/${workDir}`) : \"\"}/${file}`);\n}\n\n/** The editor-model markers for `findings`: the finding's range when it has one, else the rest of its line. */\nfunction toMarkers(\n  findings: readonly FileFinding[],\n  model: MonacoEditorApi.ITextModel,\n  monaco: Monaco,\n): MonacoEditorApi.IMarkerData[] {\n  return findings.map((finding) => {\n    const endLineNumber = finding.endLine ?? finding.line;\n    return {\n      severity: markerSeverity(monaco, finding.severity),\n      message: finding.message,\n      source: finding.source,\n      ...(finding.rule ? { code: finding.rule } : {}),\n      startLineNumber: finding.line,\n      startColumn: finding.column ?? 1,\n      endLineNumber,\n      endColumn: finding.endColumn ?? model.getLineMaxColumn(endLineNumber),\n    };\n  });\n}\n\n/**\n * One chip per line that has findings: the worst finding's `rule · message`,\n * with `+N` for the line's other findings, injected after the line's text.\n */\nfunction inlineChipDecorations(\n  findings: readonly FileFinding[],\n  model: Pick<MonacoEditorApi.ITextModel, \"getLineMaxColumn\">,\n): MonacoEditorApi.IModelDeltaDecoration[] {\n  const byLine = new Map<number, FileFinding[]>();\n  for (const finding of findings) byLine.set(finding.line, [...(byLine.get(finding.line) ?? []), finding]);\n  return [...byLine].map(([line, onLine]) => {\n    const worst = onLine.reduce((a, b) => (severityRank(b.severity) > severityRank(a.severity) ? b : a));\n    const label = worst.rule ? `${worst.rule} · ${worst.message}` : worst.message;\n    const column = model.getLineMaxColumn(line);\n    return {\n      range: { startLineNumber: line, startColumn: column, endLineNumber: line, endColumn: column },\n      options: {\n        // Monaco drops injected text on an empty range unless told to keep it.\n        showIfCollapsed: true,\n        after: {\n          content: onLine.length > 1 ? `${label} +${onLine.length - 1}` : label,\n          inlineClassName: CHIP[worst.severity],\n        },\n      },\n    };\n  });\n}\n\n/** The first finding whose line range covers `line`. */\nfunction findingCovering(findings: readonly FileFinding[], line: number): FileFinding | undefined {\n  return findings.find((f) => f.line <= line && line <= (f.endLine ?? f.line));\n}\n\nfunction CodeBody({\n  mounted,\n  onMount,\n  contentElement,\n  path,\n  workDir,\n  source,\n  findings,\n  line,\n  onLineChange,\n  getFindingActions,\n  onChange,\n  inlineChips,\n  className,\n}: AnnotatedCodeProps & {\n  mounted: MountedEditor | null;\n  onMount: (mounted: MountedEditor) => void;\n  contentElement: { current: HTMLDivElement | null };\n}) {\n  const ctx = useCommentContext();\n  const { focusAnchor, commentMeta } = ctx;\n\n  const findingsById = useMemo(() => {\n    const comments = findingsToComments(findings);\n    return new Map(comments.map((comment, i) => [comment.id, findings[i]!]));\n  }, [findings]);\n\n  // Markers and gutter decorations follow the findings.\n  useEffect(() => {\n    if (!mounted) return;\n    const { editor, monaco } = mounted;\n    const model = editor.getModel();\n    if (!model) return;\n    editor.updateOptions({ glyphMargin: true });\n    monaco.editor.setModelMarkers(model, MARKER_OWNER, toMarkers(findings, model, monaco));\n    const decorations = editor.createDecorationsCollection([\n      ...findings.map((finding) => ({\n        range: {\n          startLineNumber: finding.line,\n          startColumn: 1,\n          endLineNumber: finding.endLine ?? finding.line,\n          endColumn: 1,\n        },\n        options: {\n          isWholeLine: true,\n          className: LINE_TINT[finding.severity],\n          glyphMarginClassName: GLYPH[finding.severity],\n          glyphMarginHoverMessage: { value: finding.message },\n        },\n      })),\n      ...(inlineChips ? inlineChipDecorations(findings, model) : []),\n    ]);\n    return () => {\n      decorations.clear();\n      monaco.editor.setModelMarkers(model, MARKER_OWNER, []);\n    };\n  }, [mounted, findings, inlineChips]);\n\n  // Clicking a line a finding covers focuses its thread in the rail.\n  useEffect(() => {\n    if (!mounted) return;\n    const { editor } = mounted;\n    const subscription = editor.onMouseDown((event) => {\n      const clicked = event.target.position?.lineNumber;\n      const finding = clicked === undefined ? undefined : findingCovering(findings, clicked);\n      if (!finding) return;\n      focusAnchor(lineAnchor(finding.line));\n      onLineChange?.(finding.line);\n    });\n    return () => subscription.dispose();\n  }, [mounted, findings, focusAnchor, onLineChange]);\n\n  // The rail aligns to the editor's scroll position by listening for `scroll`\n  // on the content element, which an editor's internal scrolling never fires.\n  useEffect(() => {\n    const element = contentElement.current;\n    if (!mounted || !element) return;\n    const notify = () => element.dispatchEvent(new Event(\"scroll\"));\n    const subscription: IDisposable = mounted.editor.onDidScrollChange(notify);\n    notify();\n    return () => subscription.dispose();\n  }, [mounted, contentElement]);\n\n  useLayoutEffect(() => {\n    if (!mounted || line === undefined) return;\n    mounted.editor.revealLineInCenter(line);\n    if (commentMeta[lineAnchor(line)]) focusAnchor(lineAnchor(line));\n    // commentMeta changes identity with the comments; the reveal is per line.\n  }, [mounted, line, focusAnchor]);\n\n  return (\n    <div className={cn(\"flex h-full min-h-0\", className)} data-annotated-code=\"\">\n      <div\n        ref={(element) => {\n          ctx.contentRef.current = element;\n          contentElement.current = element;\n        }}\n        className=\"min-w-0 flex-1 [&_[data-slot=monaco-editor]]:h-full [&_[data-slot=monaco-editor]]:rounded-none [&_[data-slot=monaco-editor]]:border-0\"\n      >\n        <MonacoEditor\n          {...(onChange ? { onChange } : { readOnly: true })}\n          value={source}\n          language={findingsLanguageForPath(path)}\n          path={modelPath(workDir, path)}\n          height=\"100%\"\n          beforeMount={(monaco) => registerFindingsLanguages(monaco.languages)}\n          onMount={(editor, monaco) => onMount({ editor, monaco })}\n        />\n      </div>\n      <div className=\"shrink-0 overflow-y-auto border-l border-border px-density-3\">\n        <CommentSidePanel\n          focusedAlignment=\"anchor\"\n          formatAnchorLabel={(anchor) => `line ${lineOfAnchor(anchor)}`}\n          renderRootDetails={(comment) => {\n            const finding = findingsById.get(comment.id);\n            return finding && getFindingActions ? <ProblemActions items={getFindingActions(finding)} /> : null;\n          }}\n        />\n      </div>\n    </div>\n  );\n}\n\n/**\n * A source file in a Monaco editor with its findings as markers, as gutter\n * dots and as read-only comment threads in a rail beside it. The editor is\n * read-only unless `onChange` is given. Needs a\n * `MonacoProvider` above it. The rail and the editor share one anchor scheme\n * (`line:<n>`): the rail asks the editor where a line is and tells it to\n * reveal one.\n */\nexport function AnnotatedCode({ findings, ...props }: AnnotatedCodeProps) {\n  const [mounted, setMounted] = useState<MountedEditor | null>(null);\n  const contentElement = useRef<HTMLDivElement | null>(null);\n  const comments = useMemo(() => findingsToComments(findings), [findings]);\n\n  const getAnchorTop = useCallback(\n    (anchor: CommentAnchor): number | null => {\n      const container = contentElement.current;\n      const model = mounted?.editor.getModel();\n      const dom = mounted?.editor.getDomNode();\n      if (!mounted || !container || !model || !dom) return null;\n      const line = lineOfAnchor(anchor);\n      if (line > model.getLineCount()) return null;\n      const editorOffset = dom.getBoundingClientRect().top - container.getBoundingClientRect().top;\n      return editorOffset + mounted.editor.getTopForLineNumber(line) - mounted.editor.getScrollTop();\n    },\n    [mounted],\n  );\n\n  const onScrollToAnchor = useCallback(\n    (anchor: CommentAnchor, options: CommentScrollOptions): boolean => {\n      if (!mounted) return false;\n      const { editor, monaco } = mounted;\n      const line = lineOfAnchor(anchor);\n      if (line > (editor.getModel()?.getLineCount() ?? 0)) return false;\n      editor.revealLineInCenter(\n        line,\n        options.behavior === \"smooth\" ? monaco.editor.ScrollType.Smooth : monaco.editor.ScrollType.Immediate,\n      );\n      return true;\n    },\n    [mounted],\n  );\n\n  return (\n    <CommentProvider\n      comments={comments}\n      config={FINDINGS_COMMENT_CONFIG}\n      resolveAnchor={lineRangeAnchorResolver}\n      getAnchorTop={getAnchorTop}\n      onScrollToAnchor={onScrollToAnchor}\n      initialRailMode=\"all\"\n    >\n      <CodeBody\n        mounted={mounted}\n        onMount={setMounted}\n        contentElement={contentElement}\n        findings={findings}\n        {...props}\n      />\n    </CommentProvider>\n  );\n}\n"],"mappings":"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"}

package/dist/file-findings/FileFindingsView.cjs

@@ -0,0 +1,213 @@
+const require_utils = require("../lib/utils.cjs");
+const require_UiLoader = require("../icons/components/UiLoader.cjs");
+const require_UiFileCode = require("../icons/components/UiFileCode.cjs");
+const require_UiFolder = require("../icons/components/UiFolder.cjs");
+const require_Icon = require("../data/Icon.cjs");
+const require_Tree = require("../data/Tree.cjs");
+const require_SplitPane = require("../layout/SplitPane.cjs");
+const require_MarkIcons = require("../data/test-runner/MarkIcons.cjs");
+const require_types = require("./types.cjs");
+const require_adapters = require("./adapters.cjs");
+const require_severity_counts = require("./severity-counts.cjs");
+const require_FileReview = require("./file-review/FileReview.cjs");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+// src/file-findings/FileFindingsView.tsx
+function isMarkdownPath(path) {
+	return /\.mdx?$/i.test(path);
+}
+function SeverityCounts({ findings }) {
+	const counts = require_severity_counts.countFindingsBySeverity(findings);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+		className: "flex shrink-0 items-center gap-2 text-xs text-muted-foreground",
+		children: require_severity_counts.FINDING_SEVERITIES.filter((s) => counts[s] > 0).map((s) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+			className: "inline-flex items-center gap-0.5",
+			title: `${counts[s]} ${s}`,
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_MarkIcons.LintSeverityIcon, { severity: s }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: "tabular-nums",
+				children: counts[s]
+			})]
+		}, s))
+	});
+}
+function FileTreeRow({ node, selected }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Icon.Icon, {
+			icon: node.kind === "folder" ? require_UiFolder.UiFolder : require_UiFileCode.UiFileCode,
+			className: "shrink-0 text-muted-foreground"
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+			className: require_utils.cn("min-w-0 truncate text-foreground", selected ? "font-semibold" : "font-medium"),
+			title: node.name,
+			children: node.name
+		}),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: "flex-1" }),
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeverityCounts, { findings: node.findings })
+	] });
+}
+function findFileNode(nodes, ref) {
+	if (!ref) return null;
+	for (const node of nodes) {
+		if (node.kind === "file" && require_types.sameFileRef(node.ref ?? null, ref)) return node;
+		const found = findFileNode(node.children ?? [], ref);
+		if (found) return found;
+	}
+	return null;
+}
+/** Loads `ref`'s text whenever it changes; a result for a file that is no longer open is discarded. */
+function useFileText(ref, loadFile) {
+	const [state, setState] = (0, react.useState)(null);
+	const key = ref ? require_types.fileRefKey(ref) : null;
+	const latest = (0, react.useRef)({
+		ref,
+		loadFile
+	});
+	latest.current = {
+		ref,
+		loadFile
+	};
+	(0, react.useEffect)(() => {
+		const { ref, loadFile } = latest.current;
+		if (!ref || !key) {
+			setState(null);
+			return;
+		}
+		let current = true;
+		setState({
+			key,
+			status: "loading"
+		});
+		loadFile(ref).then((text) => current && setState({
+			key,
+			status: "ready",
+			text
+		}), (error) => current && setState({
+			key,
+			status: "error",
+			message: error instanceof Error ? error.message : String(error)
+		}));
+		return () => {
+			current = false;
+		};
+	}, [key]);
+	return state?.key === key ? state : null;
+}
+function Placeholder({ children }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: "flex h-full items-center justify-center p-8 text-sm text-muted-foreground",
+		children
+	});
+}
+function FileViewer({ file, findings, state, line, onLineChange, view, onViewChange, problemFilters, onProblemFiltersChange, getFindingActions }) {
+	const shown = !isMarkdownPath(file.file) && view === "preview" ? "source" : view;
+	let body;
+	if (!state || state.status === "loading") body = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(Placeholder, { children: [
+		/* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Icon.Icon, {
+			icon: require_UiLoader.UiLoader,
+			className: "mr-2 animate-spin"
+		}),
+		"Loading ",
+		file.file
+	] });
+	else if (state.status === "error") body = /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		role: "alert",
+		className: "m-density-4 rounded-md border border-destructive/40 p-3 text-sm text-destructive",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "font-semibold",
+			children: ["Could not load ", file.file]
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("pre", {
+			className: "mt-1 whitespace-pre-wrap break-words font-mono text-xs",
+			children: state.message
+		})]
+	});
+	else body = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_FileReview.FileReview, {
+		path: file.file,
+		source: state.text,
+		view: shown,
+		onViewChange,
+		findings,
+		problemFilters,
+		onProblemFiltersChange,
+		line,
+		onLineChange,
+		getFindingActions,
+		className: "h-full p-density-2"
+	}, require_types.fileRefKey(file));
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "flex h-full min-h-0 flex-col",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "flex min-w-0 items-center gap-2 border-b border-border px-density-4 py-density-2",
+			"data-file-header": "",
+			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: "min-w-0 truncate font-mono text-sm",
+				title: file.workDir ? `${file.workDir}/${file.file}` : file.file,
+				children: file.file
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(SeverityCounts, { findings })]
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "min-h-0 flex-1",
+			children: body
+		})]
+	});
+}
+/**
+* Every file that has lint violations or failed tests, as a tree beside a
+* `FileReview` of the open file: syntax-highlighted source with each finding
+* under its line, a rendered Preview for markdown, and a Problems list. Fully controlled:
+* the open file, line and view live in props so the host can keep them in its
+* URL, and file text comes from `loadFile`, so nothing here fetches.
+*/
+function FileFindingsView({ findings, selectedFile, onSelectFile, line, onLineChange, view, onViewChange, problemFilters, onProblemFiltersChange, loadFile, getFindingActions, defaultSplit = 28, className }) {
+	const tree = (0, react.useMemo)(() => require_adapters.groupFindingsByFile(findings), [findings]);
+	const selectedNode = (0, react.useMemo)(() => findFileNode(tree, selectedFile), [tree, selectedFile]);
+	const state = useFileText(selectedFile, loadFile);
+	const treePane = /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_Tree.Tree, {
+		className: "min-h-0",
+		roots: tree,
+		getKey: (node) => node.key,
+		getChildren: (node) => node.children,
+		selected: selectedNode,
+		onSelect: (node) => {
+			if (node.kind === "file" && node.ref) onSelectFile(node.ref);
+		},
+		defaultOpen: () => true,
+		showSearch: true,
+		searchLabel: "Filter files",
+		getSearchText: (node) => node.name,
+		empty: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: "p-8 text-center text-sm text-muted-foreground",
+			children: "No lint violations or failed tests with a file location"
+		}),
+		renderRow: ({ node, selected }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FileTreeRow, {
+			node,
+			selected
+		})
+	});
+	const viewerPane = !selectedFile ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Placeholder, { children: "Select a file to see its findings in context." }) : !selectedNode ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(Placeholder, { children: [selectedFile.file, " has no findings in this run."] }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(FileViewer, {
+		file: selectedFile,
+		findings: selectedNode.findings,
+		state,
+		line,
+		onLineChange,
+		view,
+		onViewChange,
+		problemFilters,
+		onProblemFiltersChange,
+		getFindingActions
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		className: require_utils.cn("flex h-full min-h-0 flex-col bg-background", className),
+		"data-file-findings": "",
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_SplitPane.SplitPane, {
+			className: "min-h-0 flex-1",
+			defaultSplit,
+			minLeft: 15,
+			minRight: 40,
+			leftClass: "border-r-2 border-border bg-muted/30",
+			left: treePane,
+			right: viewerPane
+		})
+	});
+}
+exports.FileFindingsView = FileFindingsView;
+
+//# sourceMappingURL=FileFindingsView.cjs.map

package/dist/file-findings/FileFindingsView.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileFindingsView.cjs","names":["countFindingsBySeverity","FINDING_SEVERITIES","LintSeverityIcon","_Fragment","Icon","UiFolder","UiFileCode","cn","sameFileRef","useState","fileRefKey","useRef","UiLoader","FileReview","useMemo","groupFindingsByFile","Tree","SplitPane"],"sources":["../../src/file-findings/FileFindingsView.tsx"],"sourcesContent":["import type { DropdownMenuItem } from \"../overlay/DropdownMenu\";\nimport { useEffect, useMemo, useRef, useState, type ReactNode } from \"react\";\nimport { Icon } from \"../data/Icon\";\nimport { Tree } from \"../data/Tree\";\nimport { LintSeverityIcon } from \"../data/test-runner/MarkIcons\";\nimport { UiFileCode, UiFolder, UiLoader } from \"../icons\";\nimport { SplitPane } from \"../layout/SplitPane\";\nimport { cn } from \"../lib/utils\";\nimport { groupFindingsByFile } from \"./adapters\";\nimport { FileReview, type FileReviewView } from \"./file-review/FileReview\";\nimport type { ProblemFilters } from \"./file-review/problem-filters\";\nimport { countFindingsBySeverity, FINDING_SEVERITIES } from \"./severity-counts\";\nimport {\n  fileRefKey,\n  sameFileRef,\n  type FileFinding,\n  type FileRef,\n  type FileTreeNode,\n} from \"./types\";\n\nexport type FileFindingsViewProps = {\n  findings: readonly FileFinding[];\n  /** The open file, or null for none. Controlled so the host can keep it in its URL. */\n  selectedFile: FileRef | null;\n  onSelectFile: (file: FileRef) => void;\n  /** Line to reveal in the open file. Controlled. */\n  line?: number | undefined;\n  onLineChange: (line: number | undefined) => void;\n  /** The open file's tab. A code file has no Preview, so \"preview\" shows its Source. Controlled. */\n  view: FileReviewView;\n  onViewChange: (view: FileReviewView) => void;\n  /** Severity and issue-type filters on the Problems tab. Controlled. */\n  problemFilters: ProblemFilters;\n  onProblemFiltersChange: (filters: ProblemFilters) => void;\n  /** Fetches a file's text. A rejection is shown to the reader in full. */\n  loadFile: (file: FileRef) => Promise<string>;\n  /** Contextual menu items for each finding in Problems, Source and Preview. */\n  getFindingActions?: ((finding: FileFinding) => DropdownMenuItem[]) | undefined;\n  /** Initial width percentage of the file tree. */\n  defaultSplit?: number | undefined;\n  className?: string | undefined;\n};\n\ntype LoadState =\n  | { key: string; status: \"loading\" }\n  | { key: string; status: \"error\"; message: string }\n  | { key: string; status: \"ready\"; text: string };\n\nfunction isMarkdownPath(path: string): boolean {\n  return /\\.mdx?$/i.test(path);\n}\n\nfunction SeverityCounts({ findings }: { findings: readonly FileFinding[] }) {\n  const counts = countFindingsBySeverity(findings);\n  return (\n    <span className=\"flex shrink-0 items-center gap-2 text-xs text-muted-foreground\">\n      {FINDING_SEVERITIES.filter((s) => counts[s] > 0).map((s) => (\n        <span key={s} className=\"inline-flex items-center gap-0.5\" title={`${counts[s]} ${s}`}>\n          <LintSeverityIcon severity={s} />\n          <span className=\"tabular-nums\">{counts[s]}</span>\n        </span>\n      ))}\n    </span>\n  );\n}\n\nfunction FileTreeRow({ node, selected }: { node: FileTreeNode; selected: boolean }) {\n  return (\n    <>\n      <Icon icon={node.kind === \"folder\" ? UiFolder : UiFileCode} className=\"shrink-0 text-muted-foreground\" />\n      <span className={cn(\"min-w-0 truncate text-foreground\", selected ? \"font-semibold\" : \"font-medium\")} title={node.name}>\n        {node.name}\n      </span>\n      <span className=\"flex-1\" />\n      <SeverityCounts findings={node.findings} />\n    </>\n  );\n}\n\nfunction findFileNode(nodes: readonly FileTreeNode[], ref: FileRef | null): FileTreeNode | null {\n  if (!ref) return null;\n  for (const node of nodes) {\n    if (node.kind === \"file\" && sameFileRef(node.ref ?? null, ref)) return node;\n    const found = findFileNode(node.children ?? [], ref);\n    if (found) return found;\n  }\n  return null;\n}\n\n/** Loads `ref`'s text whenever it changes; a result for a file that is no longer open is discarded. */\nfunction useFileText(ref: FileRef | null, loadFile: (file: FileRef) => Promise<string>): LoadState | null {\n  const [state, setState] = useState<LoadState | null>(null);\n  const key = ref ? fileRefKey(ref) : null;\n  // A host that rebuilds `ref` or `loadFile` each render must not reload the file.\n  const latest = useRef({ ref, loadFile });\n  latest.current = { ref, loadFile };\n\n  useEffect(() => {\n    const { ref, loadFile } = latest.current;\n    if (!ref || !key) {\n      setState(null);\n      return;\n    }\n    let current = true;\n    setState({ key, status: \"loading\" });\n    loadFile(ref).then(\n      (text) => current && setState({ key, status: \"ready\", text }),\n      (error: unknown) =>\n        current &&\n        setState({ key, status: \"error\", message: error instanceof Error ? error.message : String(error) }),\n    );\n    return () => {\n      current = false;\n    };\n  }, [key]);\n\n  return state?.key === key ? state : null;\n}\n\nfunction Placeholder({ children }: { children: ReactNode }) {\n  return <div className=\"flex h-full items-center justify-center p-8 text-sm text-muted-foreground\">{children}</div>;\n}\n\nfunction FileViewer({\n  file,\n  findings,\n  state,\n  line,\n  onLineChange,\n  view,\n  onViewChange,\n  problemFilters,\n  onProblemFiltersChange,\n  getFindingActions,\n}: Pick<\n  FileFindingsViewProps,\n  \"line\" | \"onLineChange\" | \"view\" | \"onViewChange\" | \"problemFilters\" | \"onProblemFiltersChange\" | \"getFindingActions\"\n> & {\n  file: FileRef;\n  findings: readonly FileFinding[];\n  state: LoadState | null;\n}) {\n  const markdown = isMarkdownPath(file.file);\n  // Moving from a markdown file to code keeps the view; code has no Preview, so it reads as Source.\n  const shown: FileReviewView = !markdown && view === \"preview\" ? \"source\" : view;\n\n  let body: ReactNode;\n  if (!state || state.status === \"loading\") {\n    body = (\n      <Placeholder>\n        <Icon icon={UiLoader} className=\"mr-2 animate-spin\" />\n        Loading {file.file}\n      </Placeholder>\n    );\n  } else if (state.status === \"error\") {\n    body = (\n      <div role=\"alert\" className=\"m-density-4 rounded-md border border-destructive/40 p-3 text-sm text-destructive\">\n        <div className=\"font-semibold\">Could not load {file.file}</div>\n        <pre className=\"mt-1 whitespace-pre-wrap break-words font-mono text-xs\">{state.message}</pre>\n      </div>\n    );\n  } else {\n    body = (\n      <FileReview\n        key={fileRefKey(file)}\n        path={file.file}\n        source={state.text}\n        view={shown}\n        onViewChange={onViewChange}\n        findings={findings}\n        problemFilters={problemFilters}\n        onProblemFiltersChange={onProblemFiltersChange}\n        line={line}\n        onLineChange={onLineChange}\n        getFindingActions={getFindingActions}\n        className=\"h-full p-density-2\"\n      />\n    );\n  }\n\n  return (\n    <div className=\"flex h-full min-h-0 flex-col\">\n      <div className=\"flex min-w-0 items-center gap-2 border-b border-border px-density-4 py-density-2\" data-file-header=\"\">\n        <span className=\"min-w-0 truncate font-mono text-sm\" title={file.workDir ? `${file.workDir}/${file.file}` : file.file}>\n          {file.file}\n        </span>\n        <SeverityCounts findings={findings} />\n      </div>\n      <div className=\"min-h-0 flex-1\">{body}</div>\n    </div>\n  );\n}\n\n/**\n * Every file that has lint violations or failed tests, as a tree beside a\n * `FileReview` of the open file: syntax-highlighted source with each finding\n * under its line, a rendered Preview for markdown, and a Problems list. Fully controlled:\n * the open file, line and view live in props so the host can keep them in its\n * URL, and file text comes from `loadFile`, so nothing here fetches.\n */\nexport function FileFindingsView({\n  findings,\n  selectedFile,\n  onSelectFile,\n  line,\n  onLineChange,\n  view,\n  onViewChange,\n  problemFilters,\n  onProblemFiltersChange,\n  loadFile,\n  getFindingActions,\n  defaultSplit = 28,\n  className,\n}: FileFindingsViewProps) {\n  const tree = useMemo(() => groupFindingsByFile(findings), [findings]);\n  const selectedNode = useMemo(() => findFileNode(tree, selectedFile), [tree, selectedFile]);\n  const state = useFileText(selectedFile, loadFile);\n\n  const treePane = (\n    <Tree<FileTreeNode>\n      className=\"min-h-0\"\n      roots={tree}\n      getKey={(node) => node.key}\n      getChildren={(node) => node.children}\n      selected={selectedNode}\n      onSelect={(node) => {\n        if (node.kind === \"file\" && node.ref) onSelectFile(node.ref);\n      }}\n      defaultOpen={() => true}\n      showSearch\n      searchLabel=\"Filter files\"\n      getSearchText={(node) => node.name}\n      empty={<div className=\"p-8 text-center text-sm text-muted-foreground\">No lint violations or failed tests with a file location</div>}\n      renderRow={({ node, selected }) => <FileTreeRow node={node} selected={selected} />}\n    />\n  );\n\n  const viewerPane = !selectedFile ? (\n    <Placeholder>Select a file to see its findings in context.</Placeholder>\n  ) : !selectedNode ? (\n    <Placeholder>{selectedFile.file} has no findings in this run.</Placeholder>\n  ) : (\n    <FileViewer\n      file={selectedFile}\n      findings={selectedNode.findings}\n      state={state}\n      line={line}\n      onLineChange={onLineChange}\n      view={view}\n      onViewChange={onViewChange}\n      problemFilters={problemFilters}\n      onProblemFiltersChange={onProblemFiltersChange}\n      getFindingActions={getFindingActions}\n    />\n  );\n\n  return (\n    <div className={cn(\"flex h-full min-h-0 flex-col bg-background\", className)} data-file-findings=\"\">\n      <SplitPane\n        className=\"min-h-0 flex-1\"\n        defaultSplit={defaultSplit}\n        minLeft={15}\n        minRight={40}\n        leftClass=\"border-r-2 border-border bg-muted/30\"\n        left={treePane}\n        right={viewerPane}\n      />\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/file-findings/FileFindingsView.d.ts

@@ -0,0 +1,35 @@
+import { DropdownMenuItem } from '../overlay/DropdownMenu.js';
+import { FileReviewView } from './file-review/FileReview.js';
+import { ProblemFilters } from './file-review/problem-filters.js';
+import { FileFinding, FileRef } from './types.js';
+export type FileFindingsViewProps = {
+    findings: readonly FileFinding[];
+    /** The open file, or null for none. Controlled so the host can keep it in its URL. */
+    selectedFile: FileRef | null;
+    onSelectFile: (file: FileRef) => void;
+    /** Line to reveal in the open file. Controlled. */
+    line?: number | undefined;
+    onLineChange: (line: number | undefined) => void;
+    /** The open file's tab. A code file has no Preview, so "preview" shows its Source. Controlled. */
+    view: FileReviewView;
+    onViewChange: (view: FileReviewView) => void;
+    /** Severity and issue-type filters on the Problems tab. Controlled. */
+    problemFilters: ProblemFilters;
+    onProblemFiltersChange: (filters: ProblemFilters) => void;
+    /** Fetches a file's text. A rejection is shown to the reader in full. */
+    loadFile: (file: FileRef) => Promise<string>;
+    /** Contextual menu items for each finding in Problems, Source and Preview. */
+    getFindingActions?: ((finding: FileFinding) => DropdownMenuItem[]) | undefined;
+    /** Initial width percentage of the file tree. */
+    defaultSplit?: number | undefined;
+    className?: string | undefined;
+};
+/**
+ * Every file that has lint violations or failed tests, as a tree beside a
+ * `FileReview` of the open file: syntax-highlighted source with each finding
+ * under its line, a rendered Preview for markdown, and a Problems list. Fully controlled:
+ * the open file, line and view live in props so the host can keep them in its
+ * URL, and file text comes from `loadFile`, so nothing here fetches.
+ */
+export declare function FileFindingsView({ findings, selectedFile, onSelectFile, line, onLineChange, view, onViewChange, problemFilters, onProblemFiltersChange, loadFile, getFindingActions, defaultSplit, className, }: FileFindingsViewProps): import("react").JSX.Element;
+//# sourceMappingURL=FileFindingsView.d.ts.map

package/dist/file-findings/FileFindingsView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileFindingsView.d.ts","sourceRoot":"","sources":["../../src/file-findings/FileFindingsView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAShE,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,OAAO,EAEb,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,sFAAsF;IACtF,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACjD,kGAAkG;IAClG,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,uEAAuE;IACvE,cAAc,EAAE,cAAc,CAAC;IAC/B,sBAAsB,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1D,yEAAyE;IACzE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW,KAAK,gBAAgB,EAAE,CAAC,GAAG,SAAS,CAAC;IAC/E,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAAC;AAwJF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,QAAQ,EACR,iBAAiB,EACjB,YAAiB,EACjB,SAAS,GACV,EAAE,qBAAqB,+BAwDvB"}