@flanksource/clicky-ui 0.3.55 → 0.3.56

package/dist/file-findings/file-review/source-anchor.cjs

@@ -0,0 +1,104 @@
+// src/file-findings/file-review/source-anchor.ts
+var SOURCE_PREFIX = "s:";
+/** Context kept on each side of a quote. */
+var CONTEXT_CHARS = 24;
+/** Longest quote shown in a thread label. */
+var LABEL_CHARS = 60;
+function sourceAnchor(locator) {
+	return `s:${JSON.stringify([
+		locator.line,
+		locator.prefix,
+		locator.quote,
+		locator.suffix
+	])}`;
+}
+/** The locator an `s:` anchor encodes; throws for a malformed one. */
+function parseSourceAnchor(anchor) {
+	if (!anchor.startsWith("s:")) throw new Error(`not a source anchor: ${JSON.stringify(anchor)}`);
+	const parsed = JSON.parse(anchor.slice(2));
+	const [line, prefix, quote, suffix] = Array.isArray(parsed) ? parsed : [];
+	if (!Number.isInteger(line) || line < 1 || typeof prefix !== "string" || typeof quote !== "string" || typeof suffix !== "string") throw new Error(`malformed source anchor ${JSON.stringify(anchor)}`);
+	return {
+		line,
+		prefix,
+		quote,
+		suffix
+	};
+}
+function lineStarts(source) {
+	const starts = [0];
+	for (let i = source.indexOf("\n"); i !== -1; i = source.indexOf("\n", i + 1)) starts.push(i + 1);
+	return starts;
+}
+/** The offset of a point; a column past the line's end (an empty line's placeholder) clamps to it. */
+function offsetOf(source, starts, point) {
+	const start = starts[point.line - 1];
+	if (start === void 0) throw new Error(`line ${point.line} is outside the ${starts.length}-line source`);
+	const end = starts[point.line] === void 0 ? source.length : starts[point.line] - 1;
+	return Math.min(start + point.column, end);
+}
+/** 1-based line holding `offset`. */
+function lineAt(starts, offset) {
+	let line = 1;
+	while (line < starts.length && starts[line] <= offset) line++;
+	return line;
+}
+/** The locator for the text between two points, or null when it is only whitespace. */
+function locateSource(source, start, end) {
+	const starts = lineStarts(source);
+	const from = offsetOf(source, starts, start);
+	const to = offsetOf(source, starts, end);
+	const quote = source.slice(from, to);
+	if (!quote.trim()) return null;
+	return {
+		line: lineAt(starts, from),
+		prefix: source.slice(Math.max(0, from - CONTEXT_CHARS), from),
+		quote,
+		suffix: source.slice(to, to + CONTEXT_CHARS)
+	};
+}
+/**
+* Where the quote is now, cut into per-line spans: the occurrence with the
+* same surrounding text that is nearest its original line. Empty when the
+* quote or its context has changed.
+*/
+function resolveSource(source, locator) {
+	const needle = locator.prefix + locator.quote + locator.suffix;
+	const starts = lineStarts(source);
+	let best = null;
+	let bestDistance = Infinity;
+	for (let i = source.indexOf(needle); i !== -1; i = source.indexOf(needle, i + 1)) {
+		const at = i + locator.prefix.length;
+		const distance = Math.abs(lineAt(starts, at) - locator.line);
+		if (distance < bestDistance) {
+			best = at;
+			bestDistance = distance;
+		}
+	}
+	if (best === null) return [];
+	const end = best + locator.quote.length;
+	const spans = [];
+	for (let line = lineAt(starts, best); line <= starts.length && starts[line - 1] < end; line++) {
+		const lineStart = starts[line - 1];
+		const lineEnd = starts[line] === void 0 ? source.length : starts[line] - 1;
+		const span = {
+			line,
+			start: Math.max(best, lineStart) - lineStart,
+			end: Math.min(end, lineEnd) - lineStart
+		};
+		if (span.end > span.start) spans.push(span);
+	}
+	return spans;
+}
+function describeSource(locator) {
+	const quote = locator.quote.replace(/\s+/g, " ").trim();
+	return `Line ${locator.line} · “${quote.length > LABEL_CHARS ? `${quote.slice(0, LABEL_CHARS)}…` : quote}”`;
+}
+exports.SOURCE_PREFIX = SOURCE_PREFIX;
+exports.describeSource = describeSource;
+exports.locateSource = locateSource;
+exports.parseSourceAnchor = parseSourceAnchor;
+exports.resolveSource = resolveSource;
+exports.sourceAnchor = sourceAnchor;
+
+//# sourceMappingURL=source-anchor.cjs.map

package/dist/file-findings/file-review/source-anchor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-anchor.cjs","names":[],"sources":["../../../src/file-findings/file-review/source-anchor.ts"],"sourcesContent":["// Anchors on text in a source file that has no rendered form (code, config):\n// the quote is found again by the characters around it, and the line it was\n// on only picks between repeats, so edits elsewhere in the file never move it.\n\nimport type { SourceSpan } from \"./quote-anchor\";\n\n/** A quote in the file with the text right before and after it, and the 1-based line it started on. */\nexport type SourceLocator = { line: number; prefix: string; quote: string; suffix: string };\n\n/** A position in the file: 1-based line, 0-based column. */\nexport type SourcePoint = { line: number; column: number };\n\nexport const SOURCE_PREFIX = \"s:\";\n\n/** Context kept on each side of a quote. */\nconst CONTEXT_CHARS = 24;\n/** Longest quote shown in a thread label. */\nconst LABEL_CHARS = 60;\n\nexport function sourceAnchor(locator: SourceLocator): string {\n  return `${SOURCE_PREFIX}${JSON.stringify([locator.line, locator.prefix, locator.quote, locator.suffix])}`;\n}\n\n/** The locator an `s:` anchor encodes; throws for a malformed one. */\nexport function parseSourceAnchor(anchor: string): SourceLocator {\n  if (!anchor.startsWith(SOURCE_PREFIX)) throw new Error(`not a source anchor: ${JSON.stringify(anchor)}`);\n  const parsed: unknown = JSON.parse(anchor.slice(SOURCE_PREFIX.length));\n  const [line, prefix, quote, suffix] = Array.isArray(parsed) ? parsed : [];\n  if (!Number.isInteger(line) || line < 1 || typeof prefix !== \"string\" || typeof quote !== \"string\" || typeof suffix !== \"string\") {\n    throw new Error(`malformed source anchor ${JSON.stringify(anchor)}`);\n  }\n  return { line, prefix, quote, suffix };\n}\n\nfunction lineStarts(source: string): number[] {\n  const starts = [0];\n  for (let i = source.indexOf(\"\\n\"); i !== -1; i = source.indexOf(\"\\n\", i + 1)) starts.push(i + 1);\n  return starts;\n}\n\n/** The offset of a point; a column past the line's end (an empty line's placeholder) clamps to it. */\nfunction offsetOf(source: string, starts: readonly number[], point: SourcePoint): number {\n  const start = starts[point.line - 1];\n  if (start === undefined) throw new Error(`line ${point.line} is outside the ${starts.length}-line source`);\n  const end = starts[point.line] === undefined ? source.length : starts[point.line]! - 1;\n  return Math.min(start + point.column, end);\n}\n\n/** 1-based line holding `offset`. */\nfunction lineAt(starts: readonly number[], offset: number): number {\n  let line = 1;\n  while (line < starts.length && starts[line]! <= offset) line++;\n  return line;\n}\n\n/** The locator for the text between two points, or null when it is only whitespace. */\nexport function locateSource(source: string, start: SourcePoint, end: SourcePoint): SourceLocator | null {\n  const starts = lineStarts(source);\n  const from = offsetOf(source, starts, start);\n  const to = offsetOf(source, starts, end);\n  const quote = source.slice(from, to);\n  if (!quote.trim()) return null;\n  return {\n    line: lineAt(starts, from),\n    prefix: source.slice(Math.max(0, from - CONTEXT_CHARS), from),\n    quote,\n    suffix: source.slice(to, to + CONTEXT_CHARS),\n  };\n}\n\n/**\n * Where the quote is now, cut into per-line spans: the occurrence with the\n * same surrounding text that is nearest its original line. Empty when the\n * quote or its context has changed.\n */\nexport function resolveSource(source: string, locator: SourceLocator): SourceSpan[] {\n  const needle = locator.prefix + locator.quote + locator.suffix;\n  const starts = lineStarts(source);\n  let best: number | null = null;\n  let bestDistance = Infinity;\n  for (let i = source.indexOf(needle); i !== -1; i = source.indexOf(needle, i + 1)) {\n    const at = i + locator.prefix.length;\n    const distance = Math.abs(lineAt(starts, at) - locator.line);\n    if (distance < bestDistance) {\n      best = at;\n      bestDistance = distance;\n    }\n  }\n  if (best === null) return [];\n  const end = best + locator.quote.length;\n  const spans: SourceSpan[] = [];\n  for (let line = lineAt(starts, best); line <= starts.length && starts[line - 1]! < end; line++) {\n    const lineStart = starts[line - 1]!;\n    const lineEnd = starts[line] === undefined ? source.length : starts[line]! - 1;\n    const span = { line, start: Math.max(best, lineStart) - lineStart, end: Math.min(end, lineEnd) - lineStart };\n    if (span.end > span.start) spans.push(span);\n  }\n  return spans;\n}\n\nexport function describeSource(locator: SourceLocator): string {\n  const quote = locator.quote.replace(/\\s+/g, \" \").trim();\n  return `Line ${locator.line} · “${quote.length > LABEL_CHARS ? `${quote.slice(0, LABEL_CHARS)}…` : quote}”`;\n}\n"],"mappings":"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"}

package/dist/file-findings/file-review/source-anchor.d.ts

@@ -0,0 +1,27 @@
+import { SourceSpan } from './quote-anchor.js';
+/** A quote in the file with the text right before and after it, and the 1-based line it started on. */
+export type SourceLocator = {
+    line: number;
+    prefix: string;
+    quote: string;
+    suffix: string;
+};
+/** A position in the file: 1-based line, 0-based column. */
+export type SourcePoint = {
+    line: number;
+    column: number;
+};
+export declare const SOURCE_PREFIX = "s:";
+export declare function sourceAnchor(locator: SourceLocator): string;
+/** The locator an `s:` anchor encodes; throws for a malformed one. */
+export declare function parseSourceAnchor(anchor: string): SourceLocator;
+/** The locator for the text between two points, or null when it is only whitespace. */
+export declare function locateSource(source: string, start: SourcePoint, end: SourcePoint): SourceLocator | null;
+/**
+ * Where the quote is now, cut into per-line spans: the occurrence with the
+ * same surrounding text that is nearest its original line. Empty when the
+ * quote or its context has changed.
+ */
+export declare function resolveSource(source: string, locator: SourceLocator): SourceSpan[];
+export declare function describeSource(locator: SourceLocator): string;
+//# sourceMappingURL=source-anchor.d.ts.map

package/dist/file-findings/file-review/source-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-anchor.d.ts","sourceRoot":"","sources":["../../../src/file-findings/file-review/source-anchor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,uGAAuG;AACvG,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,4DAA4D;AAC5D,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,eAAO,MAAM,aAAa,OAAO,CAAC;AAOlC,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE3D;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAQ/D;AAuBD,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,aAAa,GAAG,IAAI,CAYvG;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,UAAU,EAAE,CAuBlF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAG7D"}

package/dist/file-findings/file-review/source-anchor.js

@@ -0,0 +1,99 @@
+// src/file-findings/file-review/source-anchor.ts
+var SOURCE_PREFIX = "s:";
+/** Context kept on each side of a quote. */
+var CONTEXT_CHARS = 24;
+/** Longest quote shown in a thread label. */
+var LABEL_CHARS = 60;
+function sourceAnchor(locator) {
+	return `s:${JSON.stringify([
+		locator.line,
+		locator.prefix,
+		locator.quote,
+		locator.suffix
+	])}`;
+}
+/** The locator an `s:` anchor encodes; throws for a malformed one. */
+function parseSourceAnchor(anchor) {
+	if (!anchor.startsWith("s:")) throw new Error(`not a source anchor: ${JSON.stringify(anchor)}`);
+	const parsed = JSON.parse(anchor.slice(2));
+	const [line, prefix, quote, suffix] = Array.isArray(parsed) ? parsed : [];
+	if (!Number.isInteger(line) || line < 1 || typeof prefix !== "string" || typeof quote !== "string" || typeof suffix !== "string") throw new Error(`malformed source anchor ${JSON.stringify(anchor)}`);
+	return {
+		line,
+		prefix,
+		quote,
+		suffix
+	};
+}
+function lineStarts(source) {
+	const starts = [0];
+	for (let i = source.indexOf("\n"); i !== -1; i = source.indexOf("\n", i + 1)) starts.push(i + 1);
+	return starts;
+}
+/** The offset of a point; a column past the line's end (an empty line's placeholder) clamps to it. */
+function offsetOf(source, starts, point) {
+	const start = starts[point.line - 1];
+	if (start === void 0) throw new Error(`line ${point.line} is outside the ${starts.length}-line source`);
+	const end = starts[point.line] === void 0 ? source.length : starts[point.line] - 1;
+	return Math.min(start + point.column, end);
+}
+/** 1-based line holding `offset`. */
+function lineAt(starts, offset) {
+	let line = 1;
+	while (line < starts.length && starts[line] <= offset) line++;
+	return line;
+}
+/** The locator for the text between two points, or null when it is only whitespace. */
+function locateSource(source, start, end) {
+	const starts = lineStarts(source);
+	const from = offsetOf(source, starts, start);
+	const to = offsetOf(source, starts, end);
+	const quote = source.slice(from, to);
+	if (!quote.trim()) return null;
+	return {
+		line: lineAt(starts, from),
+		prefix: source.slice(Math.max(0, from - CONTEXT_CHARS), from),
+		quote,
+		suffix: source.slice(to, to + CONTEXT_CHARS)
+	};
+}
+/**
+* Where the quote is now, cut into per-line spans: the occurrence with the
+* same surrounding text that is nearest its original line. Empty when the
+* quote or its context has changed.
+*/
+function resolveSource(source, locator) {
+	const needle = locator.prefix + locator.quote + locator.suffix;
+	const starts = lineStarts(source);
+	let best = null;
+	let bestDistance = Infinity;
+	for (let i = source.indexOf(needle); i !== -1; i = source.indexOf(needle, i + 1)) {
+		const at = i + locator.prefix.length;
+		const distance = Math.abs(lineAt(starts, at) - locator.line);
+		if (distance < bestDistance) {
+			best = at;
+			bestDistance = distance;
+		}
+	}
+	if (best === null) return [];
+	const end = best + locator.quote.length;
+	const spans = [];
+	for (let line = lineAt(starts, best); line <= starts.length && starts[line - 1] < end; line++) {
+		const lineStart = starts[line - 1];
+		const lineEnd = starts[line] === void 0 ? source.length : starts[line] - 1;
+		const span = {
+			line,
+			start: Math.max(best, lineStart) - lineStart,
+			end: Math.min(end, lineEnd) - lineStart
+		};
+		if (span.end > span.start) spans.push(span);
+	}
+	return spans;
+}
+function describeSource(locator) {
+	const quote = locator.quote.replace(/\s+/g, " ").trim();
+	return `Line ${locator.line} · “${quote.length > LABEL_CHARS ? `${quote.slice(0, LABEL_CHARS)}…` : quote}”`;
+}
+export { SOURCE_PREFIX, describeSource, locateSource, parseSourceAnchor, resolveSource, sourceAnchor };
+
+//# sourceMappingURL=source-anchor.js.map

package/dist/file-findings/file-review/source-anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-anchor.js","names":[],"sources":["../../../src/file-findings/file-review/source-anchor.ts"],"sourcesContent":["// Anchors on text in a source file that has no rendered form (code, config):\n// the quote is found again by the characters around it, and the line it was\n// on only picks between repeats, so edits elsewhere in the file never move it.\n\nimport type { SourceSpan } from \"./quote-anchor\";\n\n/** A quote in the file with the text right before and after it, and the 1-based line it started on. */\nexport type SourceLocator = { line: number; prefix: string; quote: string; suffix: string };\n\n/** A position in the file: 1-based line, 0-based column. */\nexport type SourcePoint = { line: number; column: number };\n\nexport const SOURCE_PREFIX = \"s:\";\n\n/** Context kept on each side of a quote. */\nconst CONTEXT_CHARS = 24;\n/** Longest quote shown in a thread label. */\nconst LABEL_CHARS = 60;\n\nexport function sourceAnchor(locator: SourceLocator): string {\n  return `${SOURCE_PREFIX}${JSON.stringify([locator.line, locator.prefix, locator.quote, locator.suffix])}`;\n}\n\n/** The locator an `s:` anchor encodes; throws for a malformed one. */\nexport function parseSourceAnchor(anchor: string): SourceLocator {\n  if (!anchor.startsWith(SOURCE_PREFIX)) throw new Error(`not a source anchor: ${JSON.stringify(anchor)}`);\n  const parsed: unknown = JSON.parse(anchor.slice(SOURCE_PREFIX.length));\n  const [line, prefix, quote, suffix] = Array.isArray(parsed) ? parsed : [];\n  if (!Number.isInteger(line) || line < 1 || typeof prefix !== \"string\" || typeof quote !== \"string\" || typeof suffix !== \"string\") {\n    throw new Error(`malformed source anchor ${JSON.stringify(anchor)}`);\n  }\n  return { line, prefix, quote, suffix };\n}\n\nfunction lineStarts(source: string): number[] {\n  const starts = [0];\n  for (let i = source.indexOf(\"\\n\"); i !== -1; i = source.indexOf(\"\\n\", i + 1)) starts.push(i + 1);\n  return starts;\n}\n\n/** The offset of a point; a column past the line's end (an empty line's placeholder) clamps to it. */\nfunction offsetOf(source: string, starts: readonly number[], point: SourcePoint): number {\n  const start = starts[point.line - 1];\n  if (start === undefined) throw new Error(`line ${point.line} is outside the ${starts.length}-line source`);\n  const end = starts[point.line] === undefined ? source.length : starts[point.line]! - 1;\n  return Math.min(start + point.column, end);\n}\n\n/** 1-based line holding `offset`. */\nfunction lineAt(starts: readonly number[], offset: number): number {\n  let line = 1;\n  while (line < starts.length && starts[line]! <= offset) line++;\n  return line;\n}\n\n/** The locator for the text between two points, or null when it is only whitespace. */\nexport function locateSource(source: string, start: SourcePoint, end: SourcePoint): SourceLocator | null {\n  const starts = lineStarts(source);\n  const from = offsetOf(source, starts, start);\n  const to = offsetOf(source, starts, end);\n  const quote = source.slice(from, to);\n  if (!quote.trim()) return null;\n  return {\n    line: lineAt(starts, from),\n    prefix: source.slice(Math.max(0, from - CONTEXT_CHARS), from),\n    quote,\n    suffix: source.slice(to, to + CONTEXT_CHARS),\n  };\n}\n\n/**\n * Where the quote is now, cut into per-line spans: the occurrence with the\n * same surrounding text that is nearest its original line. Empty when the\n * quote or its context has changed.\n */\nexport function resolveSource(source: string, locator: SourceLocator): SourceSpan[] {\n  const needle = locator.prefix + locator.quote + locator.suffix;\n  const starts = lineStarts(source);\n  let best: number | null = null;\n  let bestDistance = Infinity;\n  for (let i = source.indexOf(needle); i !== -1; i = source.indexOf(needle, i + 1)) {\n    const at = i + locator.prefix.length;\n    const distance = Math.abs(lineAt(starts, at) - locator.line);\n    if (distance < bestDistance) {\n      best = at;\n      bestDistance = distance;\n    }\n  }\n  if (best === null) return [];\n  const end = best + locator.quote.length;\n  const spans: SourceSpan[] = [];\n  for (let line = lineAt(starts, best); line <= starts.length && starts[line - 1]! < end; line++) {\n    const lineStart = starts[line - 1]!;\n    const lineEnd = starts[line] === undefined ? source.length : starts[line]! - 1;\n    const span = { line, start: Math.max(best, lineStart) - lineStart, end: Math.min(end, lineEnd) - lineStart };\n    if (span.end > span.start) spans.push(span);\n  }\n  return spans;\n}\n\nexport function describeSource(locator: SourceLocator): string {\n  const quote = locator.quote.replace(/\\s+/g, \" \").trim();\n  return `Line ${locator.line} · “${quote.length > LABEL_CHARS ? `${quote.slice(0, LABEL_CHARS)}…` : quote}”`;\n}\n"],"mappings":"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"}

package/dist/file-findings/file-review/source-marks.cjs

@@ -0,0 +1,71 @@
+// src/file-findings/file-review/source-marks.ts
+/** The thread anchors a Source highlight covers; quote anchors hold spaces, so the attribute is a JSON list. */
+var markAnchors = (el) => JSON.parse(el.dataset.sourceComment);
+/** A source line cut wherever a syntax token or a comment highlight starts or ends. */
+function lineSegments(text, line, marks, tokens) {
+	const here = marks.flatMap((m) => m.spans.filter((s) => s.line === line).map((s) => ({
+		...s,
+		anchor: m.anchor
+	})));
+	let at = 0;
+	const starts = (tokens ?? []).map((token) => {
+		const start = at;
+		at += token.content.length;
+		return {
+			start,
+			token
+		};
+	});
+	const cuts = [.../* @__PURE__ */ new Set([
+		0,
+		text.length,
+		...here.flatMap((s) => [s.start, s.end]),
+		...starts.map((t) => t.start)
+	])].filter((cut) => cut <= text.length).sort((a, b) => a - b);
+	return cuts.slice(0, -1).map((start, i) => {
+		const token = starts.filter((t) => t.start <= start).at(-1)?.token;
+		return {
+			start,
+			text: text.slice(start, cuts[i + 1]),
+			anchors: here.filter((s) => s.start <= start && s.end > start).map((s) => s.anchor),
+			...token ? { token } : {}
+		};
+	});
+}
+/** The source points a selection runs between, or null when either end is outside the lines' text. */
+function sourceRangeOf(range) {
+	const own = (node) => (node instanceof Element ? node : node.parentElement)?.closest("[data-source-text]");
+	const point = (node, offset) => {
+		const text = own(node);
+		if (!text) return null;
+		const lead = document.createRange();
+		lead.setStart(text, 0);
+		lead.setEnd(node, offset);
+		return {
+			line: Number(text.dataset.sourceText),
+			column: lead.toString().length
+		};
+	};
+	const start = point(range.startContainer, range.startOffset);
+	const end = point(range.endContainer, range.endOffset);
+	return start && end ? {
+		start,
+		end
+	} : null;
+}
+/** The line and columns a selection covers, or null when it is not inside a single line's text. */
+function sourceSpanOf(range) {
+	const covered = sourceRangeOf(range);
+	if (!covered || covered.start.line !== covered.end.line) return null;
+	return {
+		line: covered.start.line,
+		start: covered.start.column,
+		end: covered.end.column
+	};
+}
+exports.lineSegments = lineSegments;
+exports.markAnchors = markAnchors;
+exports.sourceRangeOf = sourceRangeOf;
+exports.sourceSpanOf = sourceSpanOf;
+
+//# sourceMappingURL=source-marks.cjs.map

package/dist/file-findings/file-review/source-marks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-marks.cjs","names":[],"sources":["../../../src/file-findings/file-review/source-marks.ts"],"sourcesContent":["import type { HighlightedLine, HighlightedToken } from \"../../data/code-highlight\";\nimport type { SourceSpan } from \"./quote-anchor\";\nimport type { SourcePoint } from \"./source-anchor\";\n\n/** A comment thread's quote located in the source. */\nexport type SourceMark = { anchor: string; spans: SourceSpan[] };\n\n/** A run of one source line with one syntax token and one set of covering highlights. */\nexport type LineSegment = { start: number; text: string; anchors: string[]; token?: HighlightedToken };\n\n/** The thread anchors a Source highlight covers; quote anchors hold spaces, so the attribute is a JSON list. */\nexport const markAnchors = (el: HTMLElement): string[] => JSON.parse(el.dataset.sourceComment!);\n\n/** A source line cut wherever a syntax token or a comment highlight starts or ends. */\nexport function lineSegments(text: string, line: number, marks: readonly SourceMark[], tokens?: HighlightedLine): LineSegment[] {\n  const here = marks.flatMap((m) => m.spans.filter((s) => s.line === line).map((s) => ({ ...s, anchor: m.anchor })));\n  let at = 0;\n  const starts = (tokens ?? []).map((token) => {\n    const start = at;\n    at += token.content.length;\n    return { start, token };\n  });\n  const cuts = [...new Set([0, text.length, ...here.flatMap((s) => [s.start, s.end]), ...starts.map((t) => t.start)])]\n    .filter((cut) => cut <= text.length)\n    .sort((a, b) => a - b);\n  return cuts.slice(0, -1).map((start, i) => {\n    const token = starts.filter((t) => t.start <= start).at(-1)?.token;\n    return {\n      start,\n      text: text.slice(start, cuts[i + 1]),\n      anchors: here.filter((s) => s.start <= start && s.end > start).map((s) => s.anchor),\n      ...(token ? { token } : {}),\n    };\n  });\n}\n\n/** The source points a selection runs between, or null when either end is outside the lines' text. */\nexport function sourceRangeOf(range: Range): { start: SourcePoint; end: SourcePoint } | null {\n  const own = (node: Node) => (node instanceof Element ? node : node.parentElement)?.closest<HTMLElement>(\"[data-source-text]\");\n  const point = (node: Node, offset: number): SourcePoint | null => {\n    const text = own(node);\n    if (!text) return null;\n    const lead = document.createRange();\n    lead.setStart(text, 0);\n    lead.setEnd(node, offset);\n    return { line: Number(text.dataset.sourceText), column: lead.toString().length };\n  };\n  const start = point(range.startContainer, range.startOffset);\n  const end = point(range.endContainer, range.endOffset);\n  return start && end ? { start, end } : null;\n}\n\n/** The line and columns a selection covers, or null when it is not inside a single line's text. */\nexport function sourceSpanOf(range: Range): SourceSpan | null {\n  const covered = sourceRangeOf(range);\n  if (!covered || covered.start.line !== covered.end.line) return null;\n  return { line: covered.start.line, start: covered.start.column, end: covered.end.column };\n}\n"],"mappings":";;AAWA,IAAa,eAAe,OAA8B,KAAK,MAAM,GAAG,QAAQ,aAAc;;AAG9F,SAAgB,aAAa,MAAc,MAAc,OAA8B,QAAyC;CAC9H,MAAM,OAAO,MAAM,SAAS,MAAM,EAAE,MAAM,QAAQ,MAAM,EAAE,SAAS,IAAI,CAAC,CAAC,KAAK,OAAO;EAAE,GAAG;EAAG,QAAQ,EAAE;CAAO,EAAE,CAAC;CACjH,IAAI,KAAK;CACT,MAAM,UAAU,UAAU,CAAC,EAAA,CAAG,KAAK,UAAU;EAC3C,MAAM,QAAQ;EACd,MAAM,MAAM,QAAQ;EACpB,OAAO;GAAE;GAAO;EAAM;CACxB,CAAC;CACD,MAAM,OAAO,CAAC,mBAAG,IAAI,IAAI;EAAC;EAAG,KAAK;EAAQ,GAAG,KAAK,SAAS,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC;EAAG,GAAG,OAAO,KAAK,MAAM,EAAE,KAAK;CAAC,CAAC,CAAC,CAAC,CACjH,QAAQ,QAAQ,OAAO,KAAK,MAAM,CAAC,CACnC,MAAM,GAAG,MAAM,IAAI,CAAC;CACvB,OAAO,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK,OAAO,MAAM;EACzC,MAAM,QAAQ,OAAO,QAAQ,MAAM,EAAE,SAAS,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE;EAC7D,OAAO;GACL;GACA,MAAM,KAAK,MAAM,OAAO,KAAK,IAAI,EAAE;GACnC,SAAS,KAAK,QAAQ,MAAM,EAAE,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC,CAAC,KAAK,MAAM,EAAE,MAAM;GAClF,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;EAC3B;CACF,CAAC;AACH;;AAGA,SAAgB,cAAc,OAA+D;CAC3F,MAAM,OAAO,UAAgB,gBAAgB,UAAU,OAAO,KAAK,cAAA,EAAgB,QAAqB,oBAAoB;CAC5H,MAAM,SAAS,MAAY,WAAuC;EAChE,MAAM,OAAO,IAAI,IAAI;EACrB,IAAI,CAAC,MAAM,OAAO;EAClB,MAAM,OAAO,SAAS,YAAY;EAClC,KAAK,SAAS,MAAM,CAAC;EACrB,KAAK,OAAO,MAAM,MAAM;EACxB,OAAO;GAAE,MAAM,OAAO,KAAK,QAAQ,UAAU;GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC;EAAO;CACjF;CACA,MAAM,QAAQ,MAAM,MAAM,gBAAgB,MAAM,WAAW;CAC3D,MAAM,MAAM,MAAM,MAAM,cAAc,MAAM,SAAS;CACrD,OAAO,SAAS,MAAM;EAAE;EAAO;CAAI,IAAI;AACzC;;AAGA,SAAgB,aAAa,OAAiC;CAC5D,MAAM,UAAU,cAAc,KAAK;CACnC,IAAI,CAAC,WAAW,QAAQ,MAAM,SAAS,QAAQ,IAAI,MAAM,OAAO;CAChE,OAAO;EAAE,MAAM,QAAQ,MAAM;EAAM,OAAO,QAAQ,MAAM;EAAQ,KAAK,QAAQ,IAAI;CAAO;AAC1F"}

package/dist/file-findings/file-review/source-marks.d.ts

@@ -0,0 +1,27 @@
+import { HighlightedLine, HighlightedToken } from '../../data/code-highlight.js';
+import { SourceSpan } from './quote-anchor.js';
+import { SourcePoint } from './source-anchor.js';
+/** A comment thread's quote located in the source. */
+export type SourceMark = {
+    anchor: string;
+    spans: SourceSpan[];
+};
+/** A run of one source line with one syntax token and one set of covering highlights. */
+export type LineSegment = {
+    start: number;
+    text: string;
+    anchors: string[];
+    token?: HighlightedToken;
+};
+/** The thread anchors a Source highlight covers; quote anchors hold spaces, so the attribute is a JSON list. */
+export declare const markAnchors: (el: HTMLElement) => string[];
+/** A source line cut wherever a syntax token or a comment highlight starts or ends. */
+export declare function lineSegments(text: string, line: number, marks: readonly SourceMark[], tokens?: HighlightedLine): LineSegment[];
+/** The source points a selection runs between, or null when either end is outside the lines' text. */
+export declare function sourceRangeOf(range: Range): {
+    start: SourcePoint;
+    end: SourcePoint;
+} | null;
+/** The line and columns a selection covers, or null when it is not inside a single line's text. */
+export declare function sourceSpanOf(range: Range): SourceSpan | null;
+//# sourceMappingURL=source-marks.d.ts.map

package/dist/file-findings/file-review/source-marks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-marks.d.ts","sourceRoot":"","sources":["../../../src/file-findings/file-review/source-marks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC;AAEjE,yFAAyF;AACzF,MAAM,MAAM,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAEvG,gHAAgH;AAChH,eAAO,MAAM,WAAW,GAAI,IAAI,WAAW,KAAG,MAAM,EAA2C,CAAC;AAEhG,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,WAAW,EAAE,CAoB9H;AAED,sGAAsG;AACtG,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAa3F;AAED,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,GAAG,IAAI,CAI5D"}

package/dist/file-findings/file-review/source-marks.js

@@ -0,0 +1,68 @@
+// src/file-findings/file-review/source-marks.ts
+/** The thread anchors a Source highlight covers; quote anchors hold spaces, so the attribute is a JSON list. */
+var markAnchors = (el) => JSON.parse(el.dataset.sourceComment);
+/** A source line cut wherever a syntax token or a comment highlight starts or ends. */
+function lineSegments(text, line, marks, tokens) {
+	const here = marks.flatMap((m) => m.spans.filter((s) => s.line === line).map((s) => ({
+		...s,
+		anchor: m.anchor
+	})));
+	let at = 0;
+	const starts = (tokens ?? []).map((token) => {
+		const start = at;
+		at += token.content.length;
+		return {
+			start,
+			token
+		};
+	});
+	const cuts = [.../* @__PURE__ */ new Set([
+		0,
+		text.length,
+		...here.flatMap((s) => [s.start, s.end]),
+		...starts.map((t) => t.start)
+	])].filter((cut) => cut <= text.length).sort((a, b) => a - b);
+	return cuts.slice(0, -1).map((start, i) => {
+		const token = starts.filter((t) => t.start <= start).at(-1)?.token;
+		return {
+			start,
+			text: text.slice(start, cuts[i + 1]),
+			anchors: here.filter((s) => s.start <= start && s.end > start).map((s) => s.anchor),
+			...token ? { token } : {}
+		};
+	});
+}
+/** The source points a selection runs between, or null when either end is outside the lines' text. */
+function sourceRangeOf(range) {
+	const own = (node) => (node instanceof Element ? node : node.parentElement)?.closest("[data-source-text]");
+	const point = (node, offset) => {
+		const text = own(node);
+		if (!text) return null;
+		const lead = document.createRange();
+		lead.setStart(text, 0);
+		lead.setEnd(node, offset);
+		return {
+			line: Number(text.dataset.sourceText),
+			column: lead.toString().length
+		};
+	};
+	const start = point(range.startContainer, range.startOffset);
+	const end = point(range.endContainer, range.endOffset);
+	return start && end ? {
+		start,
+		end
+	} : null;
+}
+/** The line and columns a selection covers, or null when it is not inside a single line's text. */
+function sourceSpanOf(range) {
+	const covered = sourceRangeOf(range);
+	if (!covered || covered.start.line !== covered.end.line) return null;
+	return {
+		line: covered.start.line,
+		start: covered.start.column,
+		end: covered.end.column
+	};
+}
+export { lineSegments, markAnchors, sourceRangeOf, sourceSpanOf };
+
+//# sourceMappingURL=source-marks.js.map

package/dist/file-findings/file-review/source-marks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-marks.js","names":[],"sources":["../../../src/file-findings/file-review/source-marks.ts"],"sourcesContent":["import type { HighlightedLine, HighlightedToken } from \"../../data/code-highlight\";\nimport type { SourceSpan } from \"./quote-anchor\";\nimport type { SourcePoint } from \"./source-anchor\";\n\n/** A comment thread's quote located in the source. */\nexport type SourceMark = { anchor: string; spans: SourceSpan[] };\n\n/** A run of one source line with one syntax token and one set of covering highlights. */\nexport type LineSegment = { start: number; text: string; anchors: string[]; token?: HighlightedToken };\n\n/** The thread anchors a Source highlight covers; quote anchors hold spaces, so the attribute is a JSON list. */\nexport const markAnchors = (el: HTMLElement): string[] => JSON.parse(el.dataset.sourceComment!);\n\n/** A source line cut wherever a syntax token or a comment highlight starts or ends. */\nexport function lineSegments(text: string, line: number, marks: readonly SourceMark[], tokens?: HighlightedLine): LineSegment[] {\n  const here = marks.flatMap((m) => m.spans.filter((s) => s.line === line).map((s) => ({ ...s, anchor: m.anchor })));\n  let at = 0;\n  const starts = (tokens ?? []).map((token) => {\n    const start = at;\n    at += token.content.length;\n    return { start, token };\n  });\n  const cuts = [...new Set([0, text.length, ...here.flatMap((s) => [s.start, s.end]), ...starts.map((t) => t.start)])]\n    .filter((cut) => cut <= text.length)\n    .sort((a, b) => a - b);\n  return cuts.slice(0, -1).map((start, i) => {\n    const token = starts.filter((t) => t.start <= start).at(-1)?.token;\n    return {\n      start,\n      text: text.slice(start, cuts[i + 1]),\n      anchors: here.filter((s) => s.start <= start && s.end > start).map((s) => s.anchor),\n      ...(token ? { token } : {}),\n    };\n  });\n}\n\n/** The source points a selection runs between, or null when either end is outside the lines' text. */\nexport function sourceRangeOf(range: Range): { start: SourcePoint; end: SourcePoint } | null {\n  const own = (node: Node) => (node instanceof Element ? node : node.parentElement)?.closest<HTMLElement>(\"[data-source-text]\");\n  const point = (node: Node, offset: number): SourcePoint | null => {\n    const text = own(node);\n    if (!text) return null;\n    const lead = document.createRange();\n    lead.setStart(text, 0);\n    lead.setEnd(node, offset);\n    return { line: Number(text.dataset.sourceText), column: lead.toString().length };\n  };\n  const start = point(range.startContainer, range.startOffset);\n  const end = point(range.endContainer, range.endOffset);\n  return start && end ? { start, end } : null;\n}\n\n/** The line and columns a selection covers, or null when it is not inside a single line's text. */\nexport function sourceSpanOf(range: Range): SourceSpan | null {\n  const covered = sourceRangeOf(range);\n  if (!covered || covered.start.line !== covered.end.line) return null;\n  return { line: covered.start.line, start: covered.start.column, end: covered.end.column };\n}\n"],"mappings":";;AAWA,IAAa,eAAe,OAA8B,KAAK,MAAM,GAAG,QAAQ,aAAc;;AAG9F,SAAgB,aAAa,MAAc,MAAc,OAA8B,QAAyC;CAC9H,MAAM,OAAO,MAAM,SAAS,MAAM,EAAE,MAAM,QAAQ,MAAM,EAAE,SAAS,IAAI,CAAC,CAAC,KAAK,OAAO;EAAE,GAAG;EAAG,QAAQ,EAAE;CAAO,EAAE,CAAC;CACjH,IAAI,KAAK;CACT,MAAM,UAAU,UAAU,CAAC,EAAA,CAAG,KAAK,UAAU;EAC3C,MAAM,QAAQ;EACd,MAAM,MAAM,QAAQ;EACpB,OAAO;GAAE;GAAO;EAAM;CACxB,CAAC;CACD,MAAM,OAAO,CAAC,mBAAG,IAAI,IAAI;EAAC;EAAG,KAAK;EAAQ,GAAG,KAAK,SAAS,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC;EAAG,GAAG,OAAO,KAAK,MAAM,EAAE,KAAK;CAAC,CAAC,CAAC,CAAC,CACjH,QAAQ,QAAQ,OAAO,KAAK,MAAM,CAAC,CACnC,MAAM,GAAG,MAAM,IAAI,CAAC;CACvB,OAAO,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK,OAAO,MAAM;EACzC,MAAM,QAAQ,OAAO,QAAQ,MAAM,EAAE,SAAS,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE;EAC7D,OAAO;GACL;GACA,MAAM,KAAK,MAAM,OAAO,KAAK,IAAI,EAAE;GACnC,SAAS,KAAK,QAAQ,MAAM,EAAE,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC,CAAC,KAAK,MAAM,EAAE,MAAM;GAClF,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;EAC3B;CACF,CAAC;AACH;;AAGA,SAAgB,cAAc,OAA+D;CAC3F,MAAM,OAAO,UAAgB,gBAAgB,UAAU,OAAO,KAAK,cAAA,EAAgB,QAAqB,oBAAoB;CAC5H,MAAM,SAAS,MAAY,WAAuC;EAChE,MAAM,OAAO,IAAI,IAAI;EACrB,IAAI,CAAC,MAAM,OAAO;EAClB,MAAM,OAAO,SAAS,YAAY;EAClC,KAAK,SAAS,MAAM,CAAC;EACrB,KAAK,OAAO,MAAM,MAAM;EACxB,OAAO;GAAE,MAAM,OAAO,KAAK,QAAQ,UAAU;GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC;EAAO;CACjF;CACA,MAAM,QAAQ,MAAM,MAAM,gBAAgB,MAAM,WAAW;CAC3D,MAAM,MAAM,MAAM,MAAM,cAAc,MAAM,SAAS;CACrD,OAAO,SAAS,MAAM;EAAE;EAAO;CAAI,IAAI;AACzC;;AAGA,SAAgB,aAAa,OAAiC;CAC5D,MAAM,UAAU,cAAc,KAAK;CACnC,IAAI,CAAC,WAAW,QAAQ,MAAM,SAAS,QAAQ,IAAI,MAAM,OAAO;CAChE,OAAO;EAAE,MAAM,QAAQ,MAAM;EAAM,OAAO,QAAQ,MAAM;EAAQ,KAAK,QAAQ,IAAI;CAAO;AAC1F"}

package/dist/file-findings/findings-comments.cjs

@@ -0,0 +1,136 @@
+const require_comment_types = require("../comments/comment-types.cjs");
+// src/file-findings/findings-comments.ts
+/** Anchor of every comment for a finding on `line`. */
+function lineAnchor(line) {
+	return `line:${line}`;
+}
+/** Anchor a rendered block registers for the source lines `start`..`end`. */
+function blockAnchor(start, end) {
+	return `L${start}-${end}`;
+}
+var LINE_ANCHOR = /^line:(\d+)$/;
+var BLOCK_ANCHOR = /^L(\d+)-(\d+)$/;
+/** The line a `line:N` anchor names; throws for any other anchor. */
+function lineOfAnchor(anchor) {
+	const match = LINE_ANCHOR.exec(anchor);
+	if (!match) throw new Error(`file-findings: expected a "line:<n>" anchor, got ${JSON.stringify(anchor)}`);
+	return Number(match[1]);
+}
+/**
+* Resolves a `line:N` anchor to a registered `L<start>-<end>` block: the
+* smallest block containing N, else the nearest block starting above N, else
+* the document anchor when that is registered. A block anchor resolves to
+* itself when registered. Anything else is a bug in the caller and throws.
+*/
+var lineRangeAnchorResolver = (anchor, registered) => {
+	if (anchor === "__document__" || BLOCK_ANCHOR.test(anchor)) return registered.includes(anchor) ? anchor : null;
+	const line = lineOfAnchor(anchor);
+	const blocks = registered.flatMap((candidate) => {
+		const match = BLOCK_ANCHOR.exec(candidate);
+		return match ? [{
+			anchor: candidate,
+			start: Number(match[1]),
+			end: Number(match[2])
+		}] : [];
+	});
+	const containing = blocks.filter((b) => b.start <= line && line <= b.end).sort((a, b) => a.end - a.start - (b.end - b.start) || b.start - a.start)[0];
+	if (containing) return containing.anchor;
+	const preceding = blocks.filter((b) => b.start <= line).sort((a, b) => b.start - a.start)[0];
+	if (preceding) return preceding.anchor;
+	return registered.includes("__document__") ? require_comment_types.DOCUMENT_ANCHOR : null;
+};
+/**
+* Every severity is an unresolved, active comment: a finding has no
+* resolve/close lifecycle here, it is shown for as long as the tool reports it.
+*/
+var FINDINGS_COMMENT_CONFIG = {
+	statuses: [
+		{
+			value: "error",
+			label: "Error",
+			tone: "danger",
+			stage: "active",
+			unresolved: true
+		},
+		{
+			value: "warning",
+			label: "Warning",
+			tone: "warning",
+			stage: "active",
+			unresolved: true
+		},
+		{
+			value: "info",
+			label: "Info",
+			tone: "info",
+			stage: "active",
+			unresolved: true
+		}
+	],
+	facets: [{
+		key: "severity",
+		label: "Severity",
+		options: [
+			{
+				value: "error",
+				label: "Error",
+				tone: "danger"
+			},
+			{
+				value: "warning",
+				label: "Warning",
+				tone: "warning"
+			},
+			{
+				value: "info",
+				label: "Info",
+				tone: "info"
+			}
+		]
+	}, {
+		key: "kind",
+		label: "Kind",
+		options: [{
+			value: "lint",
+			label: "Lint",
+			tone: "neutral"
+		}, {
+			value: "test",
+			label: "Test",
+			tone: "neutral"
+		}]
+	}]
+};
+var FINDING_TIME = "1970-01-01T00:00:00.000Z";
+var ID_WIDTH = 6;
+/**
+* One root comment per finding, in order. The id is the finding's index
+* zero-padded, so comment `i` belongs to `findings[i]` and ids sort in finding
+* order. Anchor is `line:<n>`, author is the raising tool, status is the severity.
+*/
+function findingsToComments(findings) {
+	return findings.map((finding, index) => ({
+		id: `finding-${String(index).padStart(ID_WIDTH, "0")}`,
+		body: finding.rule ? `${finding.message}\n\n\`${finding.rule}\`` : finding.message,
+		createdAt: FINDING_TIME,
+		author: {
+			name: finding.source,
+			kind: "agent"
+		},
+		status: finding.severity,
+		anchor: lineAnchor(finding.line),
+		facets: {
+			severity: finding.severity,
+			source: finding.source,
+			kind: finding.kind
+		}
+	}));
+}
+exports.FINDINGS_COMMENT_CONFIG = FINDINGS_COMMENT_CONFIG;
+exports.blockAnchor = blockAnchor;
+exports.findingsToComments = findingsToComments;
+exports.lineAnchor = lineAnchor;
+exports.lineOfAnchor = lineOfAnchor;
+exports.lineRangeAnchorResolver = lineRangeAnchorResolver;
+
+//# sourceMappingURL=findings-comments.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findings-comments.cjs","names":["DOCUMENT_ANCHOR"],"sources":["../../src/file-findings/findings-comments.ts"],"sourcesContent":["// Findings as read-only clicky-ui comment threads, and the anchor scheme that\n// ties a finding's line to the rendered block (or editor line) showing it.\n\nimport { DOCUMENT_ANCHOR, type Comment, type CommentAnchor, type CommentConfig } from \"../comments/comment-types\";\nimport type { AnchorResolver } from \"../comments/comment-context\";\nimport type { FileFinding } from \"./types\";\n\n/** Anchor of every comment for a finding on `line`. */\nexport function lineAnchor(line: number): CommentAnchor {\n  return `line:${line}`;\n}\n\n/** Anchor a rendered block registers for the source lines `start`..`end`. */\nexport function blockAnchor(start: number, end: number): CommentAnchor {\n  return `L${start}-${end}`;\n}\n\nconst LINE_ANCHOR = /^line:(\\d+)$/;\nconst BLOCK_ANCHOR = /^L(\\d+)-(\\d+)$/;\n\n/** The line a `line:N` anchor names; throws for any other anchor. */\nexport function lineOfAnchor(anchor: CommentAnchor): number {\n  const match = LINE_ANCHOR.exec(anchor);\n  if (!match) throw new Error(`file-findings: expected a \"line:<n>\" anchor, got ${JSON.stringify(anchor)}`);\n  return Number(match[1]);\n}\n\n/**\n * Resolves a `line:N` anchor to a registered `L<start>-<end>` block: the\n * smallest block containing N, else the nearest block starting above N, else\n * the document anchor when that is registered. A block anchor resolves to\n * itself when registered. Anything else is a bug in the caller and throws.\n */\nexport const lineRangeAnchorResolver: AnchorResolver = (anchor, registered) => {\n  if (anchor === DOCUMENT_ANCHOR || BLOCK_ANCHOR.test(anchor)) return registered.includes(anchor) ? anchor : null;\n  const line = lineOfAnchor(anchor);\n\n  const blocks = registered.flatMap((candidate) => {\n    const match = BLOCK_ANCHOR.exec(candidate);\n    return match ? [{ anchor: candidate, start: Number(match[1]), end: Number(match[2]) }] : [];\n  });\n  const containing = blocks\n    .filter((b) => b.start <= line && line <= b.end)\n    .sort((a, b) => a.end - a.start - (b.end - b.start) || b.start - a.start)[0];\n  if (containing) return containing.anchor;\n  const preceding = blocks.filter((b) => b.start <= line).sort((a, b) => b.start - a.start)[0];\n  if (preceding) return preceding.anchor;\n  return registered.includes(DOCUMENT_ANCHOR) ? DOCUMENT_ANCHOR : null;\n};\n\n/**\n * Every severity is an unresolved, active comment: a finding has no\n * resolve/close lifecycle here, it is shown for as long as the tool reports it.\n */\nexport const FINDINGS_COMMENT_CONFIG: CommentConfig = {\n  statuses: [\n    { value: \"error\", label: \"Error\", tone: \"danger\", stage: \"active\", unresolved: true },\n    { value: \"warning\", label: \"Warning\", tone: \"warning\", stage: \"active\", unresolved: true },\n    { value: \"info\", label: \"Info\", tone: \"info\", stage: \"active\", unresolved: true },\n  ],\n  facets: [\n    {\n      key: \"severity\",\n      label: \"Severity\",\n      options: [\n        { value: \"error\", label: \"Error\", tone: \"danger\" },\n        { value: \"warning\", label: \"Warning\", tone: \"warning\" },\n        { value: \"info\", label: \"Info\", tone: \"info\" },\n      ],\n    },\n    {\n      key: \"kind\",\n      label: \"Kind\",\n      options: [\n        { value: \"lint\", label: \"Lint\", tone: \"neutral\" },\n        { value: \"test\", label: \"Test\", tone: \"neutral\" },\n      ],\n    },\n  ],\n};\n\n// A finding has no creation time of its own; one fixed instant keeps the\n// comments identical between renders and ordered by id alone.\nconst FINDING_TIME = \"1970-01-01T00:00:00.000Z\";\nconst ID_WIDTH = 6;\n\n/**\n * One root comment per finding, in order. The id is the finding's index\n * zero-padded, so comment `i` belongs to `findings[i]` and ids sort in finding\n * order. Anchor is `line:<n>`, author is the raising tool, status is the severity.\n */\nexport function findingsToComments(findings: readonly FileFinding[]): Comment[] {\n  return findings.map((finding, index) => ({\n    id: `finding-${String(index).padStart(ID_WIDTH, \"0\")}`,\n    body: finding.rule ? `${finding.message}\\n\\n\\`${finding.rule}\\`` : finding.message,\n    createdAt: FINDING_TIME,\n    author: { name: finding.source, kind: \"agent\" },\n    status: finding.severity,\n    anchor: lineAnchor(finding.line),\n    facets: { severity: finding.severity, source: finding.source, kind: finding.kind },\n  }));\n}\n"],"mappings":";;;AAQA,SAAgB,WAAW,MAA6B;CACtD,OAAO,QAAQ;AACjB;;AAGA,SAAgB,YAAY,OAAe,KAA4B;CACrE,OAAO,IAAI,MAAM,GAAG;AACtB;AAEA,IAAM,cAAc;AACpB,IAAM,eAAe;;AAGrB,SAAgB,aAAa,QAA+B;CAC1D,MAAM,QAAQ,YAAY,KAAK,MAAM;CACrC,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,oDAAoD,KAAK,UAAU,MAAM,GAAG;CACxG,OAAO,OAAO,MAAM,EAAE;AACxB;;;;;;;AAQA,IAAa,2BAA2C,QAAQ,eAAe;CAC7E,IAAI,WAAA,kBAA8B,aAAa,KAAK,MAAM,GAAG,OAAO,WAAW,SAAS,MAAM,IAAI,SAAS;CAC3G,MAAM,OAAO,aAAa,MAAM;CAEhC,MAAM,SAAS,WAAW,SAAS,cAAc;EAC/C,MAAM,QAAQ,aAAa,KAAK,SAAS;EACzC,OAAO,QAAQ,CAAC;GAAE,QAAQ;GAAW,OAAO,OAAO,MAAM,EAAE;GAAG,KAAK,OAAO,MAAM,EAAE;EAAE,CAAC,IAAI,CAAC;CAC5F,CAAC;CACD,MAAM,aAAa,OAChB,QAAQ,MAAM,EAAE,SAAS,QAAQ,QAAQ,EAAE,GAAG,CAAC,CAC/C,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;CAC5E,IAAI,YAAY,OAAO,WAAW;CAClC,MAAM,YAAY,OAAO,QAAQ,MAAM,EAAE,SAAS,IAAI,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;CAC1F,IAAI,WAAW,OAAO,UAAU;CAChC,OAAO,WAAW,SAAA,cAAwB,IAAIA,sBAAAA,kBAAkB;AAClE;;;;;AAMA,IAAa,0BAAyC;CACpD,UAAU;EACR;GAAE,OAAO;GAAS,OAAO;GAAS,MAAM;GAAU,OAAO;GAAU,YAAY;EAAK;EACpF;GAAE,OAAO;GAAW,OAAO;GAAW,MAAM;GAAW,OAAO;GAAU,YAAY;EAAK;EACzF;GAAE,OAAO;GAAQ,OAAO;GAAQ,MAAM;GAAQ,OAAO;GAAU,YAAY;EAAK;CAClF;CACA,QAAQ,CACN;EACE,KAAK;EACL,OAAO;EACP,SAAS;GACP;IAAE,OAAO;IAAS,OAAO;IAAS,MAAM;GAAS;GACjD;IAAE,OAAO;IAAW,OAAO;IAAW,MAAM;GAAU;GACtD;IAAE,OAAO;IAAQ,OAAO;IAAQ,MAAM;GAAO;EAC/C;CACF,GACA;EACE,KAAK;EACL,OAAO;EACP,SAAS,CACP;GAAE,OAAO;GAAQ,OAAO;GAAQ,MAAM;EAAU,GAChD;GAAE,OAAO;GAAQ,OAAO;GAAQ,MAAM;EAAU,CAClD;CACF,CACF;AACF;AAIA,IAAM,eAAe;AACrB,IAAM,WAAW;;;;;;AAOjB,SAAgB,mBAAmB,UAA6C;CAC9E,OAAO,SAAS,KAAK,SAAS,WAAW;EACvC,IAAI,WAAW,OAAO,KAAK,CAAC,CAAC,SAAS,UAAU,GAAG;EACnD,MAAM,QAAQ,OAAO,GAAG,QAAQ,QAAQ,QAAQ,QAAQ,KAAK,MAAM,QAAQ;EAC3E,WAAW;EACX,QAAQ;GAAE,MAAM,QAAQ;GAAQ,MAAM;EAAQ;EAC9C,QAAQ,QAAQ;EAChB,QAAQ,WAAW,QAAQ,IAAI;EAC/B,QAAQ;GAAE,UAAU,QAAQ;GAAU,QAAQ,QAAQ;GAAQ,MAAM,QAAQ;EAAK;CACnF,EAAE;AACJ"}

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

@@ -0,0 +1,28 @@
+import { Comment, CommentAnchor, CommentConfig } from '../comments/comment-types.js';
+import { AnchorResolver } from '../comments/comment-context.js';
+import { FileFinding } from './types.js';
+/** Anchor of every comment for a finding on `line`. */
+export declare function lineAnchor(line: number): CommentAnchor;
+/** Anchor a rendered block registers for the source lines `start`..`end`. */
+export declare function blockAnchor(start: number, end: number): CommentAnchor;
+/** The line a `line:N` anchor names; throws for any other anchor. */
+export declare function lineOfAnchor(anchor: CommentAnchor): number;
+/**
+ * Resolves a `line:N` anchor to a registered `L<start>-<end>` block: the
+ * smallest block containing N, else the nearest block starting above N, else
+ * the document anchor when that is registered. A block anchor resolves to
+ * itself when registered. Anything else is a bug in the caller and throws.
+ */
+export declare const lineRangeAnchorResolver: AnchorResolver;
+/**
+ * Every severity is an unresolved, active comment: a finding has no
+ * resolve/close lifecycle here, it is shown for as long as the tool reports it.
+ */
+export declare const FINDINGS_COMMENT_CONFIG: CommentConfig;
+/**
+ * One root comment per finding, in order. The id is the finding's index
+ * zero-padded, so comment `i` belongs to `findings[i]` and ids sort in finding
+ * order. Anchor is `line:<n>`, author is the raising tool, status is the severity.
+ */
+export declare function findingsToComments(findings: readonly FileFinding[]): Comment[];
+//# sourceMappingURL=findings-comments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findings-comments.d.ts","sourceRoot":"","sources":["../../src/file-findings/findings-comments.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAClH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,uDAAuD;AACvD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAEtD;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,CAErE;AAKD,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAI1D;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAerC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,aAyBrC,CAAC;AAOF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,EAAE,CAU9E"}