@flanksource/clicky-ui 0.3.55 → 0.3.56

package/dist/file-findings/file-review/SourceView.d.ts

@@ -0,0 +1,29 @@
+import { DropdownMenuItem } from '../../overlay/DropdownMenu.js';
+import { HighlightedLine } from '../../data/code-highlight.js';
+import { Comment } from '../../comments/comment-types.js';
+import { FileFinding } from '../types.js';
+import { BlameLine } from './blame.js';
+import { SourceMark } from './source-marks.js';
+/**
+ * The source with line numbers, syntax colours when `tokens` are given, and a
+ * blame column when `blame` is; a line with findings carries its worst
+ * severity's rail icon, squiggle and messages. Picking a message selects its
+ * finding. With `showFindings` off only the selected line lists its messages,
+ * and the rail icon picks a line, the way a comment highlight opens its thread.
+ * People's comments highlight their quote and list under the line that ends
+ * it; picking one opens its thread there.
+ */
+export declare function SourceView({ source, tokens, blame, findings, showFindings, marks, comments, selected, onSelect, onFocus, getFindingActions, }: {
+    source: string;
+    tokens: readonly HighlightedLine[] | null;
+    blame: ReadonlyMap<number, BlameLine> | null;
+    findings: readonly FileFinding[];
+    showFindings: boolean;
+    marks: readonly SourceMark[];
+    comments: Comment[];
+    selected: string | null;
+    onSelect: (finding: FileFinding) => void;
+    onFocus: (anchor: string | null) => void;
+    getFindingActions?: ((finding: FileFinding) => DropdownMenuItem[]) | undefined;
+}): import("react").JSX.Element;
+//# sourceMappingURL=SourceView.d.ts.map

package/dist/file-findings/file-review/SourceView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourceView.d.ts","sourceRoot":"","sources":["../../../src/file-findings/file-review/SourceView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAG5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAA2B,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAElE,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAgC/D;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,MAAM,EACN,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,iBAAiB,GAClB,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI,CAAC;IAC1C,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;IAC7C,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IACzC,iBAAiB,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW,KAAK,gBAAgB,EAAE,CAAC,GAAG,SAAS,CAAC;CAChF,+BAsGA"}

package/dist/file-findings/file-review/SourceView.js

@@ -0,0 +1,179 @@
+import { cn } from "../../lib/utils.js";
+import { getRoots, selectAnchorThreads } from "../../comments/comment-utils.js";
+import { Icon } from "../../data/Icon.js";
+import { tokenStyle } from "../../data/token-style.js";
+import { ProblemActions } from "../../data/diagnostics/ProblemActions.js";
+import { CommentAuthorAvatar } from "../../comments/CommentAuthor.js";
+import { lineAnchor } from "../findings-comments.js";
+import { SEVERITY_MARK, bySeverityThenLine, severityOf, squiggleUnder } from "./marks.js";
+import { blameAge, isUncommitted } from "./blame.js";
+import { lineSegments } from "./source-marks.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+// src/file-findings/file-review/SourceView.tsx
+/** One line's blame cell: the commit where its range opens, and an age bar on every line of the range. */
+function BlameCell({ blame }) {
+	if (!blame) return /* @__PURE__ */ jsx("span", {});
+	const { commit, first, recency } = blame;
+	const uncommitted = isUncommitted(commit);
+	return /* @__PURE__ */ jsxs("span", {
+		"data-blame-sha": first ? commit.sha : void 0,
+		title: uncommitted ? "Not committed yet" : `${commit.sha.slice(0, 12)} · ${commit.author} · ${commit.date.slice(0, 10)}\n${commit.summary}`,
+		className: cn("relative flex min-w-0 items-start gap-1.5 pl-2 pr-2 font-sans text-[11px] text-muted-foreground", first && "border-t border-border/60"),
+		children: [/* @__PURE__ */ jsx("span", {
+			"aria-hidden": true,
+			className: cn("absolute inset-y-0 left-0 w-[3px]", uncommitted ? "bg-amber-500" : "bg-sky-500"),
+			style: { opacity: uncommitted ? 1 : .15 + .85 * recency }
+		}), first && (uncommitted ? /* @__PURE__ */ jsx("span", {
+			className: "italic",
+			children: "Uncommitted"
+		}) : /* @__PURE__ */ jsxs(Fragment, { children: [
+			/* @__PURE__ */ jsx("span", {
+				className: "shrink-0 font-mono text-foreground/70",
+				children: commit.sha.slice(0, 7)
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: "min-w-0 flex-1 truncate",
+				children: commit.author
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: "shrink-0 tabular-nums",
+				children: blameAge(commit.date)
+			})
+		] }))]
+	});
+}
+/**
+* The source with line numbers, syntax colours when `tokens` are given, and a
+* blame column when `blame` is; a line with findings carries its worst
+* severity's rail icon, squiggle and messages. Picking a message selects its
+* finding. With `showFindings` off only the selected line lists its messages,
+* and the rail icon picks a line, the way a comment highlight opens its thread.
+* People's comments highlight their quote and list under the line that ends
+* it; picking one opens its thread there.
+*/
+function SourceView({ source, tokens, blame, findings, showFindings, marks, comments, selected, onSelect, onFocus, getFindingActions }) {
+	return /* @__PURE__ */ jsx("ol", {
+		className: "py-2 font-mono text-xs leading-5",
+		children: source.split("\n").map((text, i) => {
+			const line = i + 1;
+			const here = findings.filter((f) => f.line === line).sort(bySeverityThenLine);
+			const worst = here[0] ? SEVERITY_MARK[severityOf(here[0].severity)] : null;
+			const threads = marks.filter((m) => m.spans.at(-1)?.line === line);
+			const listed = showFindings || selected === lineAnchor(line) ? here : [];
+			return /* @__PURE__ */ jsxs("li", {
+				"data-source-line": line,
+				className: cn("grid pr-3", blame ? "grid-cols-[13rem_1.25rem_2.5rem_1fr]" : "grid-cols-[1.25rem_2.5rem_1fr]"),
+				children: [
+					blame && /* @__PURE__ */ jsx(BlameCell, { blame: blame.get(line) }),
+					worst && !showFindings ? /* @__PURE__ */ jsx("button", {
+						type: "button",
+						"data-source-mark": line,
+						"aria-label": `${here.length} ${here.length === 1 ? "finding" : "findings"} on line ${line}`,
+						"aria-pressed": selected === lineAnchor(line),
+						onClick: () => selected === lineAnchor(line) ? onFocus(null) : onSelect(here[0]),
+						className: cn("flex h-5 items-center justify-center rounded-sm hover:bg-muted", worst.tone),
+						children: /* @__PURE__ */ jsx(Icon, {
+							icon: worst.icon,
+							className: "text-[13px]"
+						})
+					}) : /* @__PURE__ */ jsx("span", {
+						className: cn("flex h-5 items-center justify-center", worst?.tone),
+						children: worst && /* @__PURE__ */ jsx(Icon, {
+							icon: worst.icon,
+							className: "text-[13px]"
+						})
+					}),
+					/* @__PURE__ */ jsx("span", {
+						className: "select-none pr-3 text-right text-muted-foreground tabular-nums",
+						children: line
+					}),
+					/* @__PURE__ */ jsxs("span", {
+						className: "min-w-0 whitespace-pre-wrap break-words",
+						children: [
+							/* @__PURE__ */ jsx("span", {
+								"data-source-text": line,
+								style: worst ? squiggleUnder(worst.stroke) : void 0,
+								children: text ? lineSegments(text, line, marks, tokens?.[i]).map((seg) => {
+									const style = seg.token ? tokenStyle(seg.token) : void 0;
+									return seg.anchors.length === 0 ? /* @__PURE__ */ jsx("span", {
+										style,
+										children: seg.text
+									}, seg.start) : /* @__PURE__ */ jsx("mark", {
+										"data-source-comment": JSON.stringify(seg.anchors),
+										onClick: () => window.getSelection()?.isCollapsed && onFocus(seg.anchors[0]),
+										style,
+										className: cn("cursor-pointer rounded-sm text-inherit", seg.anchors.includes(selected ?? "") ? "bg-amber-300 [[data-theme=dark]_&]:bg-amber-400/50" : "bg-amber-200/60 [[data-theme=dark]_&]:bg-amber-400/25"),
+										children: seg.text
+									}, seg.start);
+								}) : " "
+							}),
+							threads.map(({ anchor }) => {
+								const thread = selectAnchorThreads(comments, anchor);
+								const root = getRoots(thread)[0];
+								if (!root) return null;
+								return /* @__PURE__ */ jsxs("button", {
+									type: "button",
+									"data-source-thread": anchor,
+									onClick: () => onFocus(anchor),
+									className: "flex w-full items-center gap-1.5 text-left font-sans text-[11px] text-amber-600 hover:underline [[data-theme=dark]_&]:text-amber-400",
+									children: [
+										/* @__PURE__ */ jsx(CommentAuthorAvatar, {
+											author: root.author ?? null,
+											size: "xs",
+											bare: true
+										}),
+										/* @__PURE__ */ jsx("span", {
+											className: "shrink-0 font-medium text-foreground",
+											children: root.author?.name
+										}),
+										/* @__PURE__ */ jsx("span", {
+											className: "truncate text-muted-foreground",
+											children: root.body
+										}),
+										thread.length > 1 && /* @__PURE__ */ jsxs("span", {
+											className: "shrink-0 text-muted-foreground",
+											children: [
+												"· ",
+												thread.length - 1,
+												" ",
+												thread.length === 2 ? "reply" : "replies"
+											]
+										})
+									]
+								}, anchor);
+							}),
+							listed.map((f) => /* @__PURE__ */ jsxs("span", {
+								"data-source-finding": f.line,
+								className: "flex items-center gap-2",
+								children: [/* @__PURE__ */ jsxs("button", {
+									type: "button",
+									"aria-pressed": selected === lineAnchor(f.line),
+									onClick: () => onSelect(f),
+									className: cn("flex min-w-0 flex-1 items-center gap-1.5 text-left font-sans text-[11px] hover:underline aria-pressed:font-semibold aria-pressed:underline", SEVERITY_MARK[severityOf(f.severity)].tone),
+									children: [
+										/* @__PURE__ */ jsx(Icon, { icon: SEVERITY_MARK[severityOf(f.severity)].icon }),
+										/* @__PURE__ */ jsx("span", {
+											className: "text-foreground",
+											children: f.message
+										}),
+										/* @__PURE__ */ jsxs("span", {
+											className: "text-muted-foreground",
+											children: [
+												f.source,
+												" ",
+												f.rule
+											]
+										})
+									]
+								}), getFindingActions && /* @__PURE__ */ jsx(ProblemActions, { items: getFindingActions(f) })]
+							}, `${f.rule}:${f.message}`))
+						]
+					})
+				]
+			}, line);
+		})
+	});
+}
+export { SourceView };
+
+//# sourceMappingURL=SourceView.js.map

package/dist/file-findings/file-review/SourceView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourceView.js","names":["_Fragment"],"sources":["../../../src/file-findings/file-review/SourceView.tsx"],"sourcesContent":["import type { DropdownMenuItem } from \"../../overlay/DropdownMenu\";\nimport { ProblemActions } from \"../../data/diagnostics/ProblemActions\";\nimport type { HighlightedLine } from \"../../data/code-highlight\";\nimport { Icon } from \"../../data/Icon\";\nimport { tokenStyle } from \"../../data/token-style\";\nimport { cn } from \"../../lib/utils\";\nimport { CommentAuthorAvatar } from \"../../comments/CommentAuthor\";\nimport type { Comment } from \"../../comments/comment-types\";\nimport { getRoots, selectAnchorThreads } from \"../../comments/comment-utils\";\nimport { lineAnchor } from \"../findings-comments\";\nimport type { FileFinding } from \"../types\";\nimport { blameAge, isUncommitted, type BlameLine } from \"./blame\";\nimport { SEVERITY_MARK, bySeverityThenLine, severityOf, squiggleUnder } from \"./marks\";\nimport { lineSegments, type SourceMark } from \"./source-marks\";\n\n/** One line's blame cell: the commit where its range opens, and an age bar on every line of the range. */\nfunction BlameCell({ blame }: { blame: BlameLine | undefined }) {\n  if (!blame) return <span />;\n  const { commit, first, recency } = blame;\n  const uncommitted = isUncommitted(commit);\n  return (\n    <span\n      data-blame-sha={first ? commit.sha : undefined}\n      title={uncommitted ? \"Not committed yet\" : `${commit.sha.slice(0, 12)} · ${commit.author} · ${commit.date.slice(0, 10)}\\n${commit.summary}`}\n      className={cn(\"relative flex min-w-0 items-start gap-1.5 pl-2 pr-2 font-sans text-[11px] text-muted-foreground\", first && \"border-t border-border/60\")}\n    >\n      <span\n        aria-hidden\n        className={cn(\"absolute inset-y-0 left-0 w-[3px]\", uncommitted ? \"bg-amber-500\" : \"bg-sky-500\")}\n        style={{ opacity: uncommitted ? 1 : 0.15 + 0.85 * recency }}\n      />\n      {first &&\n        (uncommitted ? (\n          <span className=\"italic\">Uncommitted</span>\n        ) : (\n          <>\n            <span className=\"shrink-0 font-mono text-foreground/70\">{commit.sha.slice(0, 7)}</span>\n            <span className=\"min-w-0 flex-1 truncate\">{commit.author}</span>\n            <span className=\"shrink-0 tabular-nums\">{blameAge(commit.date)}</span>\n          </>\n        ))}\n    </span>\n  );\n}\n\n/**\n * The source with line numbers, syntax colours when `tokens` are given, and a\n * blame column when `blame` is; a line with findings carries its worst\n * severity's rail icon, squiggle and messages. Picking a message selects its\n * finding. With `showFindings` off only the selected line lists its messages,\n * and the rail icon picks a line, the way a comment highlight opens its thread.\n * People's comments highlight their quote and list under the line that ends\n * it; picking one opens its thread there.\n */\nexport function SourceView({\n  source,\n  tokens,\n  blame,\n  findings,\n  showFindings,\n  marks,\n  comments,\n  selected,\n  onSelect,\n  onFocus,\n  getFindingActions,\n}: {\n  source: string;\n  tokens: readonly HighlightedLine[] | null;\n  blame: ReadonlyMap<number, BlameLine> | null;\n  findings: readonly FileFinding[];\n  showFindings: boolean;\n  marks: readonly SourceMark[];\n  comments: Comment[];\n  selected: string | null;\n  onSelect: (finding: FileFinding) => void;\n  onFocus: (anchor: string | null) => void;\n  getFindingActions?: ((finding: FileFinding) => DropdownMenuItem[]) | undefined;\n}) {\n  return (\n    <ol className=\"py-2 font-mono text-xs leading-5\">\n      {source.split(\"\\n\").map((text, i) => {\n        const line = i + 1;\n        const here = findings.filter((f) => f.line === line).sort(bySeverityThenLine);\n        const worst = here[0] ? SEVERITY_MARK[severityOf(here[0].severity)] : null;\n        const threads = marks.filter((m) => m.spans.at(-1)?.line === line);\n        const listed = showFindings || selected === lineAnchor(line) ? here : [];\n        return (\n          <li\n            key={line}\n            data-source-line={line}\n            className={cn(\"grid pr-3\", blame ? \"grid-cols-[13rem_1.25rem_2.5rem_1fr]\" : \"grid-cols-[1.25rem_2.5rem_1fr]\")}\n          >\n            {blame && <BlameCell blame={blame.get(line)} />}\n            {worst && !showFindings ? (\n              <button\n                type=\"button\"\n                data-source-mark={line}\n                aria-label={`${here.length} ${here.length === 1 ? \"finding\" : \"findings\"} on line ${line}`}\n                aria-pressed={selected === lineAnchor(line)}\n                onClick={() => (selected === lineAnchor(line) ? onFocus(null) : onSelect(here[0]!))}\n                className={cn(\"flex h-5 items-center justify-center rounded-sm hover:bg-muted\", worst.tone)}\n              >\n                <Icon icon={worst.icon} className=\"text-[13px]\" />\n              </button>\n            ) : (\n              <span className={cn(\"flex h-5 items-center justify-center\", worst?.tone)}>{worst && <Icon icon={worst.icon} className=\"text-[13px]\" />}</span>\n            )}\n            <span className=\"select-none pr-3 text-right text-muted-foreground tabular-nums\">{line}</span>\n            <span className=\"min-w-0 whitespace-pre-wrap break-words\">\n              <span data-source-text={line} style={worst ? squiggleUnder(worst.stroke) : undefined}>\n                {text\n                  ? lineSegments(text, line, marks, tokens?.[i]).map((seg) => {\n                      const style = seg.token ? tokenStyle(seg.token) : undefined;\n                      return seg.anchors.length === 0 ? (\n                        <span key={seg.start} style={style}>\n                          {seg.text}\n                        </span>\n                      ) : (\n                        <mark\n                          key={seg.start}\n                          data-source-comment={JSON.stringify(seg.anchors)}\n                          onClick={() => window.getSelection()?.isCollapsed && onFocus(seg.anchors[0]!)}\n                          style={style}\n                          className={cn(\n                            \"cursor-pointer rounded-sm text-inherit\",\n                            seg.anchors.includes(selected ?? \"\")\n                              ? \"bg-amber-300 [[data-theme=dark]_&]:bg-amber-400/50\"\n                              : \"bg-amber-200/60 [[data-theme=dark]_&]:bg-amber-400/25\",\n                          )}\n                        >\n                          {seg.text}\n                        </mark>\n                      );\n                    })\n                  : \" \"}\n              </span>\n              {threads.map(({ anchor }) => {\n                const thread = selectAnchorThreads(comments, anchor);\n                const root = getRoots(thread)[0];\n                if (!root) return null;\n                return (\n                  <button\n                    key={anchor}\n                    type=\"button\"\n                    data-source-thread={anchor}\n                    onClick={() => onFocus(anchor)}\n                    className=\"flex w-full items-center gap-1.5 text-left font-sans text-[11px] text-amber-600 hover:underline [[data-theme=dark]_&]:text-amber-400\"\n                  >\n                    <CommentAuthorAvatar author={root.author ?? null} size=\"xs\" bare />\n                    <span className=\"shrink-0 font-medium text-foreground\">{root.author?.name}</span>\n                    <span className=\"truncate text-muted-foreground\">{root.body}</span>\n                    {thread.length > 1 && <span className=\"shrink-0 text-muted-foreground\">· {thread.length - 1} {thread.length === 2 ? \"reply\" : \"replies\"}</span>}\n                  </button>\n                );\n              })}\n              {listed.map((f) => (\n                <span key={`${f.rule}:${f.message}`} data-source-finding={f.line} className=\"flex items-center gap-2\">\n                  <button\n                    type=\"button\"\n                    aria-pressed={selected === lineAnchor(f.line)}\n                    onClick={() => onSelect(f)}\n                    className={cn(\n                      \"flex min-w-0 flex-1 items-center gap-1.5 text-left font-sans text-[11px] hover:underline aria-pressed:font-semibold aria-pressed:underline\",\n                      SEVERITY_MARK[severityOf(f.severity)].tone,\n                    )}\n                  >\n                    <Icon icon={SEVERITY_MARK[severityOf(f.severity)].icon} />\n                    <span className=\"text-foreground\">{f.message}</span>\n                    <span className=\"text-muted-foreground\">{f.source} {f.rule}</span>\n                  </button>\n                  {getFindingActions && <ProblemActions items={getFindingActions(f)} />}\n                </span>\n              ))}\n            </span>\n          </li>\n        );\n      })}\n    </ol>\n  );\n}\n"],"mappings":"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"}

package/dist/file-findings/file-review/blame.cjs

@@ -0,0 +1,35 @@
+// src/file-findings/file-review/blame.ts
+/** git blames lines not yet committed on an all-zero sha. */
+var isUncommitted = (commit) => /^0+$/.test(commit.sha);
+/** Each line's blame; throws when a range falls outside the source, since the blame then belongs to another revision. */
+function blameLines(ranges, lineCount) {
+	const times = ranges.map((range) => Date.parse(range.commit.date));
+	const oldest = Math.min(...times);
+	const span = Math.max(...times) - oldest;
+	const lines = /* @__PURE__ */ new Map();
+	ranges.forEach((range, i) => {
+		const last = range.startLine + range.lineCount - 1;
+		if (range.startLine < 1 || range.lineCount < 1 || last > lineCount) throw new Error(`blame covers lines ${range.startLine}-${last} but the source has ${lineCount} lines`);
+		const recency = span > 0 ? (times[i] - oldest) / span : 1;
+		for (let line = range.startLine; line <= last; line++) lines.set(line, {
+			commit: range.commit,
+			first: line === range.startLine,
+			recency
+		});
+	});
+	return lines;
+}
+var DAY_MS = 864e5;
+/** A commit's age at a glance: "today", "5d", "3mo", "2y". */
+function blameAge(iso, now = /* @__PURE__ */ new Date()) {
+	const days = Math.floor((now.getTime() - Date.parse(iso)) / DAY_MS);
+	if (days < 1) return "today";
+	if (days < 30) return `${days}d`;
+	if (days < 365) return `${Math.floor(days / 30)}mo`;
+	return `${Math.floor(days / 365)}y`;
+}
+exports.blameAge = blameAge;
+exports.blameLines = blameLines;
+exports.isUncommitted = isUncommitted;
+
+//# sourceMappingURL=blame.cjs.map

package/dist/file-findings/file-review/blame.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"blame.cjs","names":[],"sources":["../../../src/file-findings/file-review/blame.ts"],"sourcesContent":["/** The commit that last changed a run of lines, as `git blame` reports it. */\nexport type BlameCommit = {\n  sha: string;\n  author: string;\n  /** ISO 8601 author date. */\n  date: string;\n  /** First line of the commit message. */\n  summary: string;\n};\n\n/** Consecutive lines (1-based `startLine`) last changed by one commit. */\nexport type BlameRange = { startLine: number; lineCount: number; commit: BlameCommit };\n\n/** A line's blame: its range's commit, whether it opens the range, and its age from 0 (oldest in the file) to 1 (newest). */\nexport type BlameLine = { commit: BlameCommit; first: boolean; recency: number };\n\n/** git blames lines not yet committed on an all-zero sha. */\nexport const isUncommitted = (commit: BlameCommit) => /^0+$/.test(commit.sha);\n\n/** Each line's blame; throws when a range falls outside the source, since the blame then belongs to another revision. */\nexport function blameLines(ranges: readonly BlameRange[], lineCount: number): Map<number, BlameLine> {\n  const times = ranges.map((range) => Date.parse(range.commit.date));\n  const oldest = Math.min(...times);\n  const span = Math.max(...times) - oldest;\n  const lines = new Map<number, BlameLine>();\n  ranges.forEach((range, i) => {\n    const last = range.startLine + range.lineCount - 1;\n    if (range.startLine < 1 || range.lineCount < 1 || last > lineCount) {\n      throw new Error(`blame covers lines ${range.startLine}-${last} but the source has ${lineCount} lines`);\n    }\n    const recency = span > 0 ? (times[i]! - oldest) / span : 1;\n    for (let line = range.startLine; line <= last; line++) {\n      lines.set(line, { commit: range.commit, first: line === range.startLine, recency });\n    }\n  });\n  return lines;\n}\n\nconst DAY_MS = 86_400_000;\n\n/** A commit's age at a glance: \"today\", \"5d\", \"3mo\", \"2y\". */\nexport function blameAge(iso: string, now: Date = new Date()): string {\n  const days = Math.floor((now.getTime() - Date.parse(iso)) / DAY_MS);\n  if (days < 1) return \"today\";\n  if (days < 30) return `${days}d`;\n  if (days < 365) return `${Math.floor(days / 30)}mo`;\n  return `${Math.floor(days / 365)}y`;\n}\n"],"mappings":";;AAiBA,IAAa,iBAAiB,WAAwB,OAAO,KAAK,OAAO,GAAG;;AAG5E,SAAgB,WAAW,QAA+B,WAA2C;CACnG,MAAM,QAAQ,OAAO,KAAK,UAAU,KAAK,MAAM,MAAM,OAAO,IAAI,CAAC;CACjE,MAAM,SAAS,KAAK,IAAI,GAAG,KAAK;CAChC,MAAM,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI;CAClC,MAAM,wBAAQ,IAAI,IAAuB;CACzC,OAAO,SAAS,OAAO,MAAM;EAC3B,MAAM,OAAO,MAAM,YAAY,MAAM,YAAY;EACjD,IAAI,MAAM,YAAY,KAAK,MAAM,YAAY,KAAK,OAAO,WACvD,MAAM,IAAI,MAAM,sBAAsB,MAAM,UAAU,GAAG,KAAK,sBAAsB,UAAU,OAAO;EAEvG,MAAM,UAAU,OAAO,KAAK,MAAM,KAAM,UAAU,OAAO;EACzD,KAAK,IAAI,OAAO,MAAM,WAAW,QAAQ,MAAM,QAC7C,MAAM,IAAI,MAAM;GAAE,QAAQ,MAAM;GAAQ,OAAO,SAAS,MAAM;GAAW;EAAQ,CAAC;CAEtF,CAAC;CACD,OAAO;AACT;AAEA,IAAM,SAAS;;AAGf,SAAgB,SAAS,KAAa,sBAAY,IAAI,KAAK,GAAW;CACpE,MAAM,OAAO,KAAK,OAAO,IAAI,QAAQ,IAAI,KAAK,MAAM,GAAG,KAAK,MAAM;CAClE,IAAI,OAAO,GAAG,OAAO;CACrB,IAAI,OAAO,IAAI,OAAO,GAAG,KAAK;CAC9B,IAAI,OAAO,KAAK,OAAO,GAAG,KAAK,MAAM,OAAO,EAAE,EAAE;CAChD,OAAO,GAAG,KAAK,MAAM,OAAO,GAAG,EAAE;AACnC"}

package/dist/file-findings/file-review/blame.d.ts

@@ -0,0 +1,28 @@
+/** The commit that last changed a run of lines, as `git blame` reports it. */
+export type BlameCommit = {
+    sha: string;
+    author: string;
+    /** ISO 8601 author date. */
+    date: string;
+    /** First line of the commit message. */
+    summary: string;
+};
+/** Consecutive lines (1-based `startLine`) last changed by one commit. */
+export type BlameRange = {
+    startLine: number;
+    lineCount: number;
+    commit: BlameCommit;
+};
+/** A line's blame: its range's commit, whether it opens the range, and its age from 0 (oldest in the file) to 1 (newest). */
+export type BlameLine = {
+    commit: BlameCommit;
+    first: boolean;
+    recency: number;
+};
+/** git blames lines not yet committed on an all-zero sha. */
+export declare const isUncommitted: (commit: BlameCommit) => boolean;
+/** Each line's blame; throws when a range falls outside the source, since the blame then belongs to another revision. */
+export declare function blameLines(ranges: readonly BlameRange[], lineCount: number): Map<number, BlameLine>;
+/** A commit's age at a glance: "today", "5d", "3mo", "2y". */
+export declare function blameAge(iso: string, now?: Date): string;
+//# sourceMappingURL=blame.d.ts.map

package/dist/file-findings/file-review/blame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blame.d.ts","sourceRoot":"","sources":["../../../src/file-findings/file-review/blame.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,UAAU,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC;AAEvF,6HAA6H;AAC7H,MAAM,MAAM,SAAS,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjF,6DAA6D;AAC7D,eAAO,MAAM,aAAa,GAAI,QAAQ,WAAW,YAA4B,CAAC;AAE9E,yHAAyH;AACzH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAgBnG;AAID,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAMpE"}

package/dist/file-findings/file-review/blame.js

@@ -0,0 +1,33 @@
+// src/file-findings/file-review/blame.ts
+/** git blames lines not yet committed on an all-zero sha. */
+var isUncommitted = (commit) => /^0+$/.test(commit.sha);
+/** Each line's blame; throws when a range falls outside the source, since the blame then belongs to another revision. */
+function blameLines(ranges, lineCount) {
+	const times = ranges.map((range) => Date.parse(range.commit.date));
+	const oldest = Math.min(...times);
+	const span = Math.max(...times) - oldest;
+	const lines = /* @__PURE__ */ new Map();
+	ranges.forEach((range, i) => {
+		const last = range.startLine + range.lineCount - 1;
+		if (range.startLine < 1 || range.lineCount < 1 || last > lineCount) throw new Error(`blame covers lines ${range.startLine}-${last} but the source has ${lineCount} lines`);
+		const recency = span > 0 ? (times[i] - oldest) / span : 1;
+		for (let line = range.startLine; line <= last; line++) lines.set(line, {
+			commit: range.commit,
+			first: line === range.startLine,
+			recency
+		});
+	});
+	return lines;
+}
+var DAY_MS = 864e5;
+/** A commit's age at a glance: "today", "5d", "3mo", "2y". */
+function blameAge(iso, now = /* @__PURE__ */ new Date()) {
+	const days = Math.floor((now.getTime() - Date.parse(iso)) / DAY_MS);
+	if (days < 1) return "today";
+	if (days < 30) return `${days}d`;
+	if (days < 365) return `${Math.floor(days / 30)}mo`;
+	return `${Math.floor(days / 365)}y`;
+}
+export { blameAge, blameLines, isUncommitted };
+
+//# sourceMappingURL=blame.js.map

package/dist/file-findings/file-review/blame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blame.js","names":[],"sources":["../../../src/file-findings/file-review/blame.ts"],"sourcesContent":["/** The commit that last changed a run of lines, as `git blame` reports it. */\nexport type BlameCommit = {\n  sha: string;\n  author: string;\n  /** ISO 8601 author date. */\n  date: string;\n  /** First line of the commit message. */\n  summary: string;\n};\n\n/** Consecutive lines (1-based `startLine`) last changed by one commit. */\nexport type BlameRange = { startLine: number; lineCount: number; commit: BlameCommit };\n\n/** A line's blame: its range's commit, whether it opens the range, and its age from 0 (oldest in the file) to 1 (newest). */\nexport type BlameLine = { commit: BlameCommit; first: boolean; recency: number };\n\n/** git blames lines not yet committed on an all-zero sha. */\nexport const isUncommitted = (commit: BlameCommit) => /^0+$/.test(commit.sha);\n\n/** Each line's blame; throws when a range falls outside the source, since the blame then belongs to another revision. */\nexport function blameLines(ranges: readonly BlameRange[], lineCount: number): Map<number, BlameLine> {\n  const times = ranges.map((range) => Date.parse(range.commit.date));\n  const oldest = Math.min(...times);\n  const span = Math.max(...times) - oldest;\n  const lines = new Map<number, BlameLine>();\n  ranges.forEach((range, i) => {\n    const last = range.startLine + range.lineCount - 1;\n    if (range.startLine < 1 || range.lineCount < 1 || last > lineCount) {\n      throw new Error(`blame covers lines ${range.startLine}-${last} but the source has ${lineCount} lines`);\n    }\n    const recency = span > 0 ? (times[i]! - oldest) / span : 1;\n    for (let line = range.startLine; line <= last; line++) {\n      lines.set(line, { commit: range.commit, first: line === range.startLine, recency });\n    }\n  });\n  return lines;\n}\n\nconst DAY_MS = 86_400_000;\n\n/** A commit's age at a glance: \"today\", \"5d\", \"3mo\", \"2y\". */\nexport function blameAge(iso: string, now: Date = new Date()): string {\n  const days = Math.floor((now.getTime() - Date.parse(iso)) / DAY_MS);\n  if (days < 1) return \"today\";\n  if (days < 30) return `${days}d`;\n  if (days < 365) return `${Math.floor(days / 30)}mo`;\n  return `${Math.floor(days / 365)}y`;\n}\n"],"mappings":";;AAiBA,IAAa,iBAAiB,WAAwB,OAAO,KAAK,OAAO,GAAG;;AAG5E,SAAgB,WAAW,QAA+B,WAA2C;CACnG,MAAM,QAAQ,OAAO,KAAK,UAAU,KAAK,MAAM,MAAM,OAAO,IAAI,CAAC;CACjE,MAAM,SAAS,KAAK,IAAI,GAAG,KAAK;CAChC,MAAM,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI;CAClC,MAAM,wBAAQ,IAAI,IAAuB;CACzC,OAAO,SAAS,OAAO,MAAM;EAC3B,MAAM,OAAO,MAAM,YAAY,MAAM,YAAY;EACjD,IAAI,MAAM,YAAY,KAAK,MAAM,YAAY,KAAK,OAAO,WACvD,MAAM,IAAI,MAAM,sBAAsB,MAAM,UAAU,GAAG,KAAK,sBAAsB,UAAU,OAAO;EAEvG,MAAM,UAAU,OAAO,KAAK,MAAM,KAAM,UAAU,OAAO;EACzD,KAAK,IAAI,OAAO,MAAM,WAAW,QAAQ,MAAM,QAC7C,MAAM,IAAI,MAAM;GAAE,QAAQ,MAAM;GAAQ,OAAO,SAAS,MAAM;GAAW;EAAQ,CAAC;CAEtF,CAAC;CACD,OAAO;AACT;AAEA,IAAM,SAAS;;AAGf,SAAgB,SAAS,KAAa,sBAAY,IAAI,KAAK,GAAW;CACpE,MAAM,OAAO,KAAK,OAAO,IAAI,QAAQ,IAAI,KAAK,MAAM,GAAG,KAAK,MAAM;CAClE,IAAI,OAAO,GAAG,OAAO;CACrB,IAAI,OAAO,IAAI,OAAO,GAAG,KAAK;CAC9B,IAAI,OAAO,KAAK,OAAO,GAAG,KAAK,MAAM,OAAO,EAAE,EAAE;CAChD,OAAO,GAAG,KAAK,MAAM,OAAO,GAAG,EAAE;AACnC"}

package/dist/file-findings/file-review/geometry.cjs

@@ -0,0 +1,101 @@
+const require_findings_comments = require("../findings-comments.cjs");
+const require_quote_anchor = require("./quote-anchor.cjs");
+// src/file-findings/file-review/geometry.ts
+var SOURCE_BLOCK = "[data-source-start]";
+/** The rendered source block holding `node`, if any. */
+function sourceBlockOf(node) {
+	return (node instanceof Element ? node : node?.parentElement ?? null)?.closest(SOURCE_BLOCK) ?? null;
+}
+/**
+* Boxes for each anchor, relative to `origin`. A `q:` anchor finds its quote in
+* `markdown` through its section and context words; a `line:N` anchor resolves to its block like a line finding's
+* does. An anchor that no longer finds its target is left out. Entries come
+* in document order.
+*/
+function measureAnchors({ origin, markdown, anchors, mode }) {
+	const base = origin.getBoundingClientRect();
+	const rel = (rect) => ({
+		top: rect.top - base.top,
+		left: rect.left - base.left,
+		width: rect.width,
+		height: rect.height
+	});
+	const blocks = /* @__PURE__ */ new Map();
+	for (const el of markdown.querySelectorAll(SOURCE_BLOCK)) {
+		const key = require_findings_comments.blockAnchor(Number(el.dataset.sourceStart), Number(el.dataset.sourceEnd));
+		if (!blocks.has(key)) blocks.set(key, el);
+	}
+	const found = [];
+	for (const anchor of anchors) {
+		if (anchor.startsWith("q:")) {
+			const range = require_quote_anchor.resolveQuote(markdown, require_quote_anchor.parseQuoteAnchor(anchor));
+			if (!range) continue;
+			const text = [...range.getClientRects()].filter((rect) => rect.width > 0).map(rel);
+			const block = sourceBlockOf(range.startContainer);
+			const boxes = mode === "text" ? text : block ? [rel(block.getBoundingClientRect())] : [];
+			if (boxes.length > 0) found.push({
+				anchor,
+				boxes,
+				at: text[0]?.top ?? boxes[0].top
+			});
+			continue;
+		}
+		const key = require_findings_comments.lineRangeAnchorResolver(anchor, [...blocks.keys()]);
+		const block = key ? blocks.get(key) : void 0;
+		if (block) {
+			const range = document.createRange();
+			range.selectNodeContents(block);
+			const lines = textLines([...range.getClientRects()].filter((rect) => rect.width > 0).map(rel));
+			const boxes = lines.length > 0 ? lines : [rel(block.getBoundingClientRect())];
+			found.push({
+				anchor,
+				boxes,
+				at: boxes[0].top
+			});
+		}
+	}
+	return new Map(found.sort((a, b) => a.at - b.at).map(({ anchor, boxes }) => [anchor, boxes]));
+}
+/**
+* One box per visual line: text rects that overlap vertically merge into their
+* horizontal union, so a finding's squiggle runs under each rendered line.
+*/
+function textLines(rects) {
+	const lines = [];
+	for (const rect of [...rects].sort((a, b) => a.top - b.top || a.left - b.left)) {
+		const line = lines.find((l) => rect.top < l.top + l.height && rect.top + rect.height > l.top);
+		if (!line) {
+			lines.push({ ...rect });
+			continue;
+		}
+		const right = Math.max(line.left + line.width, rect.left + rect.width);
+		const bottom = Math.max(line.top + line.height, rect.top + rect.height);
+		line.left = Math.min(line.left, rect.left);
+		line.top = Math.min(line.top, rect.top);
+		line.width = right - line.left;
+		line.height = bottom - line.top;
+	}
+	return lines;
+}
+/**
+* Margin layout in the style of Google Docs: each card wants the top of its
+* anchor; the focused card gets exactly that, cards above it are pushed up and
+* cards below it pushed down so none overlap.
+*/
+function layoutCards({ cards, focused, gap = 8 }) {
+	const sorted = [...cards].sort((a, b) => a.desired - b.desired || a.order - b.order);
+	const tops = sorted.map((card) => card.desired);
+	const pivot = sorted.findIndex((card) => card.anchor === focused);
+	if (pivot >= 0) for (let i = pivot - 1; i >= 0; i--) tops[i] = Math.min(tops[i], tops[i + 1] - gap - sorted[i].height);
+	for (let i = 0; i < sorted.length; i++) {
+		const floor = i === 0 ? 0 : tops[i - 1] + sorted[i - 1].height + gap;
+		tops[i] = Math.max(tops[i], floor);
+	}
+	return new Map(sorted.map((card, i) => [card.anchor, tops[i]]));
+}
+exports.layoutCards = layoutCards;
+exports.measureAnchors = measureAnchors;
+exports.sourceBlockOf = sourceBlockOf;
+exports.textLines = textLines;
+
+//# sourceMappingURL=geometry.cjs.map

package/dist/file-findings/file-review/geometry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.cjs","names":["blockAnchor","resolveQuote","parseQuoteAnchor","lineRangeAnchorResolver"],"sources":["../../../src/file-findings/file-review/geometry.ts"],"sourcesContent":["import { blockAnchor, lineRangeAnchorResolver } from \"../findings-comments\";\n\nimport { QUOTE_PREFIX, parseQuoteAnchor, resolveQuote } from \"./quote-anchor\";\n\n/** A rectangle relative to the annotated document's top-left corner. */\nexport type Box = { top: number; left: number; width: number; height: number };\n\n/** How a quote anchor is drawn: its exact text, or the whole block holding it. */\nexport type AnchorMode = \"text\" | \"block\";\n\nconst SOURCE_BLOCK = \"[data-source-start]\";\n\n/** The rendered source block holding `node`, if any. */\nexport function sourceBlockOf(node: Node | null): Element | null {\n  const element = node instanceof Element ? node : (node?.parentElement ?? null);\n  return element?.closest(SOURCE_BLOCK) ?? null;\n}\n\n/**\n * Boxes for each anchor, relative to `origin`. A `q:` anchor finds its quote in\n * `markdown` through its section and context words; a `line:N` anchor resolves to its block like a line finding's\n * does. An anchor that no longer finds its target is left out. Entries come\n * in document order.\n */\nexport function measureAnchors({\n  origin,\n  markdown,\n  anchors,\n  mode,\n}: {\n  origin: Element;\n  markdown: Element;\n  anchors: readonly string[];\n  mode: AnchorMode;\n}): Map<string, Box[]> {\n  const base = origin.getBoundingClientRect();\n  const rel = (rect: DOMRect): Box => ({\n    top: rect.top - base.top,\n    left: rect.left - base.left,\n    width: rect.width,\n    height: rect.height,\n  });\n  const blocks = new Map<string, Element>();\n  for (const el of markdown.querySelectorAll<HTMLElement>(SOURCE_BLOCK)) {\n    const key = blockAnchor(Number(el.dataset.sourceStart), Number(el.dataset.sourceEnd));\n    if (!blocks.has(key)) blocks.set(key, el);\n  }\n\n  // `at` is where the anchored text itself starts, so anchors sharing a block keep document order.\n  const found: { anchor: string; boxes: Box[]; at: number }[] = [];\n  for (const anchor of anchors) {\n    if (anchor.startsWith(QUOTE_PREFIX)) {\n      const range = resolveQuote(markdown, parseQuoteAnchor(anchor));\n      if (!range) continue;\n      const text = [...range.getClientRects()].filter((rect) => rect.width > 0).map(rel);\n      const block = sourceBlockOf(range.startContainer);\n      const boxes = mode === \"text\" ? text : block ? [rel(block.getBoundingClientRect())] : [];\n      if (boxes.length > 0) found.push({ anchor, boxes, at: text[0]?.top ?? boxes[0]!.top });\n      continue;\n    }\n    const key = lineRangeAnchorResolver(anchor, [...blocks.keys()]);\n    const block = key ? blocks.get(key) : undefined;\n    if (block) {\n      const range = document.createRange();\n      range.selectNodeContents(block);\n      const lines = textLines([...range.getClientRects()].filter((rect) => rect.width > 0).map(rel));\n      const boxes = lines.length > 0 ? lines : [rel(block.getBoundingClientRect())];\n      found.push({ anchor, boxes, at: boxes[0]!.top });\n    }\n  }\n  return new Map(found.sort((a, b) => a.at - b.at).map(({ anchor, boxes }) => [anchor, boxes]));\n}\n\n/**\n * One box per visual line: text rects that overlap vertically merge into their\n * horizontal union, so a finding's squiggle runs under each rendered line.\n */\nexport function textLines(rects: readonly Box[]): Box[] {\n  const lines: Box[] = [];\n  for (const rect of [...rects].sort((a, b) => a.top - b.top || a.left - b.left)) {\n    const line = lines.find((l) => rect.top < l.top + l.height && rect.top + rect.height > l.top);\n    if (!line) {\n      lines.push({ ...rect });\n      continue;\n    }\n    const right = Math.max(line.left + line.width, rect.left + rect.width);\n    const bottom = Math.max(line.top + line.height, rect.top + rect.height);\n    line.left = Math.min(line.left, rect.left);\n    line.top = Math.min(line.top, rect.top);\n    line.width = right - line.left;\n    line.height = bottom - line.top;\n  }\n  return lines;\n}\n\n/**\n * Margin layout in the style of Google Docs: each card wants the top of its\n * anchor; the focused card gets exactly that, cards above it are pushed up and\n * cards below it pushed down so none overlap.\n */\nexport function layoutCards({\n  cards,\n  focused,\n  gap = 8,\n}: {\n  /** `order` breaks ties between cards that want the same top, e.g. two quotes in one block. */\n  cards: readonly { anchor: string; desired: number; order: number; height: number }[];\n  focused: string | null;\n  gap?: number;\n}): Map<string, number> {\n  const sorted = [...cards].sort((a, b) => a.desired - b.desired || a.order - b.order);\n  const tops = sorted.map((card) => card.desired);\n  const pivot = sorted.findIndex((card) => card.anchor === focused);\n  if (pivot >= 0) {\n    for (let i = pivot - 1; i >= 0; i--) {\n      tops[i] = Math.min(tops[i]!, tops[i + 1]! - gap - sorted[i]!.height);\n    }\n  }\n  // Cards pushed above the top, and everything below the pivot, flow downward.\n  for (let i = 0; i < sorted.length; i++) {\n    const floor = i === 0 ? 0 : tops[i - 1]! + sorted[i - 1]!.height + gap;\n    tops[i] = Math.max(tops[i]!, floor);\n  }\n  return new Map(sorted.map((card, i) => [card.anchor, tops[i]!]));\n}\n"],"mappings":"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"}

package/dist/file-findings/file-review/geometry.d.ts

@@ -0,0 +1,45 @@
+/** A rectangle relative to the annotated document's top-left corner. */
+export type Box = {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+};
+/** How a quote anchor is drawn: its exact text, or the whole block holding it. */
+export type AnchorMode = "text" | "block";
+/** The rendered source block holding `node`, if any. */
+export declare function sourceBlockOf(node: Node | null): Element | null;
+/**
+ * Boxes for each anchor, relative to `origin`. A `q:` anchor finds its quote in
+ * `markdown` through its section and context words; a `line:N` anchor resolves to its block like a line finding's
+ * does. An anchor that no longer finds its target is left out. Entries come
+ * in document order.
+ */
+export declare function measureAnchors({ origin, markdown, anchors, mode, }: {
+    origin: Element;
+    markdown: Element;
+    anchors: readonly string[];
+    mode: AnchorMode;
+}): Map<string, Box[]>;
+/**
+ * One box per visual line: text rects that overlap vertically merge into their
+ * horizontal union, so a finding's squiggle runs under each rendered line.
+ */
+export declare function textLines(rects: readonly Box[]): Box[];
+/**
+ * Margin layout in the style of Google Docs: each card wants the top of its
+ * anchor; the focused card gets exactly that, cards above it are pushed up and
+ * cards below it pushed down so none overlap.
+ */
+export declare function layoutCards({ cards, focused, gap, }: {
+    /** `order` breaks ties between cards that want the same top, e.g. two quotes in one block. */
+    cards: readonly {
+        anchor: string;
+        desired: number;
+        order: number;
+        height: number;
+    }[];
+    focused: string | null;
+    gap?: number;
+}): Map<string, number>;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/file-findings/file-review/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../../src/file-findings/file-review/geometry.ts"],"names":[],"mappings":"AAIA,wEAAwE;AACxE,MAAM,MAAM,GAAG,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAI1C,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,IAAI,CAG/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,GACL,EAAE;IACD,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,IAAI,EAAE,UAAU,CAAC;CAClB,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAqCrB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,CAgBtD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,OAAO,EACP,GAAO,GACR,EAAE;IACD,8FAA8F;IAC9F,KAAK,EAAE,SAAS;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAetB"}

package/dist/file-findings/file-review/geometry.js

@@ -0,0 +1,98 @@
+import { blockAnchor, lineRangeAnchorResolver } from "../findings-comments.js";
+import { parseQuoteAnchor, resolveQuote } from "./quote-anchor.js";
+// src/file-findings/file-review/geometry.ts
+var SOURCE_BLOCK = "[data-source-start]";
+/** The rendered source block holding `node`, if any. */
+function sourceBlockOf(node) {
+	return (node instanceof Element ? node : node?.parentElement ?? null)?.closest(SOURCE_BLOCK) ?? null;
+}
+/**
+* Boxes for each anchor, relative to `origin`. A `q:` anchor finds its quote in
+* `markdown` through its section and context words; a `line:N` anchor resolves to its block like a line finding's
+* does. An anchor that no longer finds its target is left out. Entries come
+* in document order.
+*/
+function measureAnchors({ origin, markdown, anchors, mode }) {
+	const base = origin.getBoundingClientRect();
+	const rel = (rect) => ({
+		top: rect.top - base.top,
+		left: rect.left - base.left,
+		width: rect.width,
+		height: rect.height
+	});
+	const blocks = /* @__PURE__ */ new Map();
+	for (const el of markdown.querySelectorAll(SOURCE_BLOCK)) {
+		const key = blockAnchor(Number(el.dataset.sourceStart), Number(el.dataset.sourceEnd));
+		if (!blocks.has(key)) blocks.set(key, el);
+	}
+	const found = [];
+	for (const anchor of anchors) {
+		if (anchor.startsWith("q:")) {
+			const range = resolveQuote(markdown, parseQuoteAnchor(anchor));
+			if (!range) continue;
+			const text = [...range.getClientRects()].filter((rect) => rect.width > 0).map(rel);
+			const block = sourceBlockOf(range.startContainer);
+			const boxes = mode === "text" ? text : block ? [rel(block.getBoundingClientRect())] : [];
+			if (boxes.length > 0) found.push({
+				anchor,
+				boxes,
+				at: text[0]?.top ?? boxes[0].top
+			});
+			continue;
+		}
+		const key = lineRangeAnchorResolver(anchor, [...blocks.keys()]);
+		const block = key ? blocks.get(key) : void 0;
+		if (block) {
+			const range = document.createRange();
+			range.selectNodeContents(block);
+			const lines = textLines([...range.getClientRects()].filter((rect) => rect.width > 0).map(rel));
+			const boxes = lines.length > 0 ? lines : [rel(block.getBoundingClientRect())];
+			found.push({
+				anchor,
+				boxes,
+				at: boxes[0].top
+			});
+		}
+	}
+	return new Map(found.sort((a, b) => a.at - b.at).map(({ anchor, boxes }) => [anchor, boxes]));
+}
+/**
+* One box per visual line: text rects that overlap vertically merge into their
+* horizontal union, so a finding's squiggle runs under each rendered line.
+*/
+function textLines(rects) {
+	const lines = [];
+	for (const rect of [...rects].sort((a, b) => a.top - b.top || a.left - b.left)) {
+		const line = lines.find((l) => rect.top < l.top + l.height && rect.top + rect.height > l.top);
+		if (!line) {
+			lines.push({ ...rect });
+			continue;
+		}
+		const right = Math.max(line.left + line.width, rect.left + rect.width);
+		const bottom = Math.max(line.top + line.height, rect.top + rect.height);
+		line.left = Math.min(line.left, rect.left);
+		line.top = Math.min(line.top, rect.top);
+		line.width = right - line.left;
+		line.height = bottom - line.top;
+	}
+	return lines;
+}
+/**
+* Margin layout in the style of Google Docs: each card wants the top of its
+* anchor; the focused card gets exactly that, cards above it are pushed up and
+* cards below it pushed down so none overlap.
+*/
+function layoutCards({ cards, focused, gap = 8 }) {
+	const sorted = [...cards].sort((a, b) => a.desired - b.desired || a.order - b.order);
+	const tops = sorted.map((card) => card.desired);
+	const pivot = sorted.findIndex((card) => card.anchor === focused);
+	if (pivot >= 0) for (let i = pivot - 1; i >= 0; i--) tops[i] = Math.min(tops[i], tops[i + 1] - gap - sorted[i].height);
+	for (let i = 0; i < sorted.length; i++) {
+		const floor = i === 0 ? 0 : tops[i - 1] + sorted[i - 1].height + gap;
+		tops[i] = Math.max(tops[i], floor);
+	}
+	return new Map(sorted.map((card, i) => [card.anchor, tops[i]]));
+}
+export { layoutCards, measureAnchors, sourceBlockOf, textLines };
+
+//# sourceMappingURL=geometry.js.map