@athenaintel/react 0.40.3 → 0.41.0

package/dist/references/src/anchors/format.cjs

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const sheetName = require("../sheet-name.cjs");
+const SHORT_EXCERPT_CHARS = 8;
+const LONG_EXCERPT_CHARS = 20;
+function formatAnchorTime(timestamp) {
+  const parts = timestamp.split(":");
+  if (parts.length !== 3) return timestamp;
+  const [hours, minutes, seconds] = parts.map((part) => Number.parseInt(part, 10));
+  if ([hours, minutes, seconds].some((part) => Number.isNaN(part)) || hours < 0 || minutes < 0 || minutes >= 60 || seconds < 0 || seconds >= 60) {
+    return timestamp;
+  }
+  const paddedSeconds = seconds.toString().padStart(2, "0");
+  if (hours > 0) return `${hours}:${minutes.toString().padStart(2, "0")}:${paddedSeconds}`;
+  return `${minutes}:${paddedSeconds}`;
+}
+function slideName(anchor) {
+  return anchor.slideIndex != null ? `Slide ${anchor.slideIndex}` : "Slide";
+}
+function truncate(text, max) {
+  if (text.length <= max) return text;
+  return `${text.slice(0, max)}…`;
+}
+function formatFileLineRange(anchor, mode) {
+  const path = mode === "short" ? anchor.path.split("/").pop() ?? anchor.path : anchor.path;
+  const lines = anchor.startLine === anchor.endLine ? `${anchor.startLine}` : `${anchor.startLine}-${anchor.endLine}`;
+  return `${path}:${lines}`;
+}
+function formatAnchorShort(anchor) {
+  switch (anchor.type) {
+    case "cell":
+      return `cell ${truncate(anchor.cellId, SHORT_EXCERPT_CHARS)}`;
+    case "cell_range":
+      return `cells ${truncate(anchor.startCellId, SHORT_EXCERPT_CHARS)} - ${truncate(anchor.endCellId, SHORT_EXCERPT_CHARS)}`;
+    case "file_line_range":
+      return formatFileLineRange(anchor, "short");
+    case "line":
+      return `L${anchor.line}`;
+    case "line_range":
+      return `L${anchor.startLine}-${anchor.endLine}`;
+    case "msg":
+      return "Msg";
+    case "msg_range":
+      return "Msgs";
+    case "msg_block":
+      return `¶${anchor.block}`;
+    case "msg_section":
+      return truncate(anchor.heading, SHORT_EXCERPT_CHARS);
+    case "msg_text":
+      return truncate(anchor.text, SHORT_EXCERPT_CHARS);
+    case "tool_call":
+      return "Tool call";
+    case "page":
+      return `p.${anchor.page}`;
+    case "page_range":
+      return `p.${anchor.startPage}-${anchor.endPage}`;
+    case "page_rect":
+      return `p.${anchor.page} (Region)`;
+    case "page_text":
+      return `p.${anchor.page}`;
+    case "path":
+      return anchor.line != null ? `${truncate(anchor.path, SHORT_EXCERPT_CHARS)}:${anchor.line}` : truncate(anchor.path, SHORT_EXCERPT_CHARS);
+    case "pm_node":
+    case "pm_node_range":
+    case "pm_mark":
+      return "§";
+    case "pixel_range":
+      return "Region";
+    case "rect":
+      return "Region";
+    case "shape": {
+      const n = anchor.shapeIds.length;
+      return n === 1 ? `${slideName(anchor)} • shape` : `${slideName(anchor)} • ${n} shapes`;
+    }
+    case "sheet_cell":
+      return anchor.cell;
+    case "sheet_range":
+      return anchor.range;
+    case "sheet_tab":
+      return "Sheet tab";
+    case "slide":
+      return slideName(anchor);
+    case "semantic_query":
+      return anchor.field ? `Cube · ${truncate(anchor.field, SHORT_EXCERPT_CHARS)}` : "Cube query";
+    case "sql_query":
+      return anchor.field ? `SQL · ${truncate(anchor.field, SHORT_EXCERPT_CHARS)}` : "SQL query";
+    case "time":
+      return formatAnchorTime(anchor.time);
+    case "time_range":
+      return `${formatAnchorTime(anchor.startTime)}-${formatAnchorTime(anchor.endTime)}`;
+    case "comment":
+    case "comment_thread":
+      return "💬";
+    default:
+      return "•";
+  }
+}
+function formatAnchorLong(anchor) {
+  switch (anchor.type) {
+    case "cell":
+      return `Cell ${truncate(anchor.cellId, LONG_EXCERPT_CHARS)}`;
+    case "cell_range":
+      return `Cells ${truncate(anchor.startCellId, LONG_EXCERPT_CHARS)}–${truncate(anchor.endCellId, LONG_EXCERPT_CHARS)}`;
+    case "file_line_range":
+      return formatFileLineRange(anchor, "long");
+    case "line":
+      return `Line ${anchor.line}`;
+    case "line_range":
+      return `Lines ${anchor.startLine}–${anchor.endLine}`;
+    case "msg":
+      return "Message";
+    case "msg_range":
+      return "Messages";
+    case "msg_block":
+      return `Message block ${anchor.block}`;
+    case "msg_section":
+      return `Section · ${anchor.heading}`;
+    case "msg_text":
+      return truncate(anchor.text, LONG_EXCERPT_CHARS);
+    case "tool_call":
+      return "Tool call";
+    case "page":
+      return `Page ${anchor.page}`;
+    case "page_range":
+      return `Pages ${anchor.startPage}–${anchor.endPage}`;
+    case "page_rect":
+      return `Page ${anchor.page} (Region)`;
+    case "page_text":
+      return `Page ${anchor.page}`;
+    case "path":
+      return anchor.line != null ? `${anchor.path}:${anchor.line}${anchor.column != null ? `:${anchor.column}` : ""}` : anchor.path;
+    case "pm_node":
+    case "pm_node_range":
+    case "pm_mark":
+      return "§";
+    case "pixel_range":
+      return "Region";
+    case "rect":
+      return "Region";
+    case "shape": {
+      const n = anchor.shapeIds.length;
+      return n === 1 ? `${slideName(anchor)} — 1 shape` : `${slideName(anchor)} — ${n} shapes`;
+    }
+    case "sheet_cell":
+      return `Cell ${anchor.cell}`;
+    case "sheet_range":
+      return `Range ${anchor.range}`;
+    case "sheet_tab":
+      return "Sheet tab";
+    case "slide":
+      return slideName(anchor);
+    case "semantic_query":
+      return anchor.field ? `Cube query · ${truncate(anchor.field, LONG_EXCERPT_CHARS)}` : "Cube query";
+    case "sql_query":
+      return anchor.field ? `SQL query · ${truncate(anchor.field, LONG_EXCERPT_CHARS)}` : "SQL query";
+    case "time":
+      return formatAnchorTime(anchor.time);
+    case "time_range":
+      return `${formatAnchorTime(anchor.startTime)} – ${formatAnchorTime(anchor.endTime)}`;
+    case "comment":
+    case "comment_thread":
+      return "Comment";
+    default:
+      return "";
+  }
+}
+function isExcerptOnlyAnchor(anchor) {
+  return anchor.type === "pm_node" || anchor.type === "pm_node_range" || anchor.type === "pm_mark" || anchor.type === "msg_text";
+}
+function anchorExcerpt({ anchor, meta }) {
+  if (anchor.type === "page_text") return anchor.text;
+  if (anchor.type === "msg_text") return (meta == null ? void 0 : meta.excerpt) || anchor.text;
+  return meta == null ? void 0 : meta.excerpt;
+}
+function formatShort(anchor, meta) {
+  const excerpt = anchorExcerpt({ anchor, meta });
+  const sheetName$1 = meta == null ? void 0 : meta.sheetName;
+  if (excerpt) {
+    const anchorPart = formatAnchorShort(anchor);
+    if (isExcerptOnlyAnchor(anchor)) {
+      return truncate(excerpt, SHORT_EXCERPT_CHARS);
+    }
+    if (sheetName$1 && (anchor.type === "sheet_cell" || anchor.type === "sheet_range" || anchor.type === "sheet_tab")) {
+      return anchor.type === "sheet_tab" ? sheetName$1 : `${sheetName.quoteSheetName(sheetName$1)}!${anchorPart}`;
+    }
+    return anchorPart;
+  }
+  if (sheetName$1 && (anchor.type === "sheet_cell" || anchor.type === "sheet_range" || anchor.type === "sheet_tab")) {
+    return anchor.type === "sheet_tab" ? sheetName$1 : `${sheetName.quoteSheetName(sheetName$1)}!${formatAnchorShort(anchor)}`;
+  }
+  return formatAnchorShort(anchor);
+}
+function formatLong(anchor, meta) {
+  const excerpt = anchorExcerpt({ anchor, meta });
+  const sheetName$1 = meta == null ? void 0 : meta.sheetName;
+  if (excerpt) {
+    let anchorPart = formatAnchorLong(anchor);
+    if (sheetName$1 && (anchor.type === "sheet_cell" || anchor.type === "sheet_range" || anchor.type === "sheet_tab")) {
+      anchorPart = anchor.type === "sheet_tab" ? `Sheet tab · ${sheetName$1}` : `${sheetName.quoteSheetName(sheetName$1)}!${anchor.type === "sheet_cell" ? anchor.cell : anchor.range}`;
+    }
+    if (isExcerptOnlyAnchor(anchor)) {
+      return truncate(excerpt, LONG_EXCERPT_CHARS);
+    }
+    return `${anchorPart}: ${truncate(excerpt, LONG_EXCERPT_CHARS)}`;
+  }
+  if (sheetName$1 && (anchor.type === "sheet_cell" || anchor.type === "sheet_range" || anchor.type === "sheet_tab")) {
+    if (anchor.type === "sheet_tab") {
+      return `Sheet tab · ${sheetName$1}`;
+    }
+    return `${sheetName.quoteSheetName(sheetName$1)}!${anchor.type === "sheet_cell" ? anchor.cell : anchor.range}`;
+  }
+  return formatAnchorLong(anchor);
+}
+function formatReferenceAnchor(anchor, mode = "long", meta) {
+  const text = mode === "short" ? formatShort(anchor, meta) : formatLong(anchor, meta);
+  return text === "" ? null : text;
+}
+exports.formatReferenceAnchor = formatReferenceAnchor;
+//# sourceMappingURL=format.cjs.map

package/dist/references/src/anchors/format.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.cjs","sources":["../../../../../references/src/anchors/format.ts"],"sourcesContent":["/**\n * `formatReferenceAnchor` — format an anchor into a human-readable citation line.\n *\n * Accepts the `Anchor` directly (+ optional `AssetMeta` for excerpt / sheetName context).\n * Returns `null` when there is nothing to format. Every renderer of a citation\n * chip labels its anchor with it: Olympus's mention chips and the\n * `@athenaintel/react` SDK's chat chips (through `@athenaintel/references/asset-links`).\n */\n\nimport { quoteSheetName } from '../sheet-name';\nimport type { AssetMeta } from '../types';\nimport type { Anchor, FileLineRangeAnchor, ShapeAnchor, SlideAnchor } from './types';\n\nexport type ReferenceAnchorFormatMode = 'short' | 'long';\n\nconst SHORT_EXCERPT_CHARS = 8;\nconst LONG_EXCERPT_CHARS = 20;\n\n/**\n * A stored `HH:MM:SS` time anchor as a reader sees it (`00:05:30` → `5:30`,\n * `01:05:30` → `1:05:30`); anything else is shown as written.\n */\nfunction formatAnchorTime(timestamp: string): string {\n  const parts = timestamp.split(':');\n  if (parts.length !== 3) return timestamp;\n  const [hours, minutes, seconds] = parts.map((part) => Number.parseInt(part, 10));\n  if (\n    [hours, minutes, seconds].some((part) => Number.isNaN(part)) ||\n    hours < 0 ||\n    minutes < 0 ||\n    minutes >= 60 ||\n    seconds < 0 ||\n    seconds >= 60\n  ) {\n    return timestamp;\n  }\n  const paddedSeconds = seconds.toString().padStart(2, '0');\n  if (hours > 0) return `${hours}:${minutes.toString().padStart(2, '0')}:${paddedSeconds}`;\n  return `${minutes}:${paddedSeconds}`;\n}\n\n/** `Slide N` by its 1-based display position; a slide cited by id alone is just `Slide`. */\nfunction slideName(anchor: SlideAnchor | ShapeAnchor): string {\n  return anchor.slideIndex != null ? `Slide ${anchor.slideIndex}` : 'Slide';\n}\n\nfunction truncate(text: string, max: number): string {\n  if (text.length <= max) return text;\n  return `${text.slice(0, max)}…`;\n}\n\n/**\n * `path:startLine-endLine`, or `path:startLine` when the range is one line.\n * The short form names the file by its basename (`indexer.py:10-42`); a path\n * is never head-truncated, which would cut off the part that identifies it.\n */\nfunction formatFileLineRange(anchor: FileLineRangeAnchor, mode: ReferenceAnchorFormatMode): string {\n  const path = mode === 'short' ? (anchor.path.split('/').pop() ?? anchor.path) : anchor.path;\n  const lines =\n    anchor.startLine === anchor.endLine\n      ? `${anchor.startLine}`\n      : `${anchor.startLine}-${anchor.endLine}`;\n  return `${path}:${lines}`;\n}\n\nfunction formatAnchorShort(anchor: Anchor): string {\n  switch (anchor.type) {\n    case 'cell':\n      return `cell ${truncate(anchor.cellId, SHORT_EXCERPT_CHARS)}`;\n    case 'cell_range':\n      return `cells ${truncate(anchor.startCellId, SHORT_EXCERPT_CHARS)} - ${truncate(anchor.endCellId, SHORT_EXCERPT_CHARS)}`;\n    case 'file_line_range':\n      return formatFileLineRange(anchor, 'short');\n    case 'line':\n      return `L${anchor.line}`;\n    case 'line_range':\n      return `L${anchor.startLine}-${anchor.endLine}`;\n    case 'msg':\n      return 'Msg';\n    case 'msg_range':\n      return 'Msgs';\n    case 'msg_block':\n      return `¶${anchor.block}`;\n    case 'msg_section':\n      return truncate(anchor.heading, SHORT_EXCERPT_CHARS);\n    case 'msg_text':\n      return truncate(anchor.text, SHORT_EXCERPT_CHARS);\n    case 'tool_call':\n      return 'Tool call';\n    case 'page':\n      return `p.${anchor.page}`;\n    case 'page_range':\n      return `p.${anchor.startPage}-${anchor.endPage}`;\n    case 'page_rect':\n      return `p.${anchor.page} (Region)`;\n    case 'page_text':\n      return `p.${anchor.page}`;\n    case 'path':\n      return anchor.line != null\n        ? `${truncate(anchor.path, SHORT_EXCERPT_CHARS)}:${anchor.line}`\n        : truncate(anchor.path, SHORT_EXCERPT_CHARS);\n    case 'pm_node':\n    case 'pm_node_range':\n    case 'pm_mark':\n      return '§';\n    case 'pixel_range':\n      return 'Region';\n    case 'rect':\n      return 'Region';\n    case 'shape': {\n      const n = anchor.shapeIds.length;\n      return n === 1 ? `${slideName(anchor)} • shape` : `${slideName(anchor)} • ${n} shapes`;\n    }\n    case 'sheet_cell':\n      return anchor.cell;\n    case 'sheet_range':\n      return anchor.range;\n    case 'sheet_tab':\n      return 'Sheet tab';\n    case 'slide':\n      return slideName(anchor);\n    case 'semantic_query':\n      return anchor.field ? `Cube · ${truncate(anchor.field, SHORT_EXCERPT_CHARS)}` : 'Cube query';\n    case 'sql_query':\n      return anchor.field ? `SQL · ${truncate(anchor.field, SHORT_EXCERPT_CHARS)}` : 'SQL query';\n    case 'time':\n      return formatAnchorTime(anchor.time);\n    case 'time_range':\n      return `${formatAnchorTime(anchor.startTime)}-${formatAnchorTime(anchor.endTime)}`;\n    case 'comment':\n    case 'comment_thread':\n      return '💬';\n    default:\n      return '•';\n  }\n}\n\nfunction formatAnchorLong(anchor: Anchor): string {\n  switch (anchor.type) {\n    case 'cell':\n      return `Cell ${truncate(anchor.cellId, LONG_EXCERPT_CHARS)}`;\n    case 'cell_range':\n      return `Cells ${truncate(anchor.startCellId, LONG_EXCERPT_CHARS)}–${truncate(anchor.endCellId, LONG_EXCERPT_CHARS)}`;\n    case 'file_line_range':\n      return formatFileLineRange(anchor, 'long');\n    case 'line':\n      return `Line ${anchor.line}`;\n    case 'line_range':\n      return `Lines ${anchor.startLine}–${anchor.endLine}`;\n    case 'msg':\n      return 'Message';\n    case 'msg_range':\n      return 'Messages';\n    case 'msg_block':\n      return `Message block ${anchor.block}`;\n    case 'msg_section':\n      return `Section · ${anchor.heading}`;\n    case 'msg_text':\n      return truncate(anchor.text, LONG_EXCERPT_CHARS);\n    case 'tool_call':\n      return 'Tool call';\n    case 'page':\n      return `Page ${anchor.page}`;\n    case 'page_range':\n      return `Pages ${anchor.startPage}–${anchor.endPage}`;\n    case 'page_rect':\n      return `Page ${anchor.page} (Region)`;\n    case 'page_text':\n      return `Page ${anchor.page}`;\n    case 'path':\n      return anchor.line != null\n        ? `${anchor.path}:${anchor.line}${anchor.column != null ? `:${anchor.column}` : ''}`\n        : anchor.path;\n    case 'pm_node':\n    case 'pm_node_range':\n    case 'pm_mark':\n      return '§';\n    case 'pixel_range':\n      return 'Region';\n    case 'rect':\n      return 'Region';\n    case 'shape': {\n      const n = anchor.shapeIds.length;\n      return n === 1 ? `${slideName(anchor)} — 1 shape` : `${slideName(anchor)} — ${n} shapes`;\n    }\n    case 'sheet_cell':\n      return `Cell ${anchor.cell}`;\n    case 'sheet_range':\n      return `Range ${anchor.range}`;\n    case 'sheet_tab':\n      return 'Sheet tab';\n    case 'slide':\n      return slideName(anchor);\n    case 'semantic_query':\n      return anchor.field\n        ? `Cube query · ${truncate(anchor.field, LONG_EXCERPT_CHARS)}`\n        : 'Cube query';\n    case 'sql_query':\n      return anchor.field\n        ? `SQL query · ${truncate(anchor.field, LONG_EXCERPT_CHARS)}`\n        : 'SQL query';\n    case 'time':\n      return formatAnchorTime(anchor.time);\n    case 'time_range':\n      return `${formatAnchorTime(anchor.startTime)} – ${formatAnchorTime(anchor.endTime)}`;\n    case 'comment':\n    case 'comment_thread':\n      return 'Comment';\n    default:\n      return '';\n  }\n}\n\n/** Anchors whose excerpt *is* the label — the location alone says nothing to a reader. */\nfunction isExcerptOnlyAnchor(anchor: Anchor): boolean {\n  return (\n    anchor.type === 'pm_node' ||\n    anchor.type === 'pm_node_range' ||\n    anchor.type === 'pm_mark' ||\n    anchor.type === 'msg_text'\n  );\n}\n\nfunction anchorExcerpt({ anchor, meta }: { anchor: Anchor; meta?: AssetMeta }): string | undefined {\n  if (anchor.type === 'page_text') return anchor.text;\n  if (anchor.type === 'msg_text') return meta?.excerpt || anchor.text;\n  return meta?.excerpt;\n}\n\nfunction formatShort(anchor: Anchor, meta?: AssetMeta): string {\n  const excerpt = anchorExcerpt({ anchor, meta });\n  const sheetName = meta?.sheetName;\n\n  if (excerpt) {\n    const anchorPart = formatAnchorShort(anchor);\n    if (isExcerptOnlyAnchor(anchor)) {\n      return truncate(excerpt, SHORT_EXCERPT_CHARS);\n    }\n    if (\n      sheetName &&\n      (anchor.type === 'sheet_cell' || anchor.type === 'sheet_range' || anchor.type === 'sheet_tab')\n    ) {\n      return anchor.type === 'sheet_tab' ? sheetName : `${quoteSheetName(sheetName)}!${anchorPart}`;\n    }\n    return anchorPart;\n  }\n  if (\n    sheetName &&\n    (anchor.type === 'sheet_cell' || anchor.type === 'sheet_range' || anchor.type === 'sheet_tab')\n  ) {\n    return anchor.type === 'sheet_tab'\n      ? sheetName\n      : `${quoteSheetName(sheetName)}!${formatAnchorShort(anchor)}`;\n  }\n  return formatAnchorShort(anchor);\n}\n\nfunction formatLong(anchor: Anchor, meta?: AssetMeta): string {\n  const excerpt = anchorExcerpt({ anchor, meta });\n  const sheetName = meta?.sheetName;\n\n  if (excerpt) {\n    let anchorPart = formatAnchorLong(anchor);\n    if (\n      sheetName &&\n      (anchor.type === 'sheet_cell' || anchor.type === 'sheet_range' || anchor.type === 'sheet_tab')\n    ) {\n      anchorPart =\n        anchor.type === 'sheet_tab'\n          ? `Sheet tab · ${sheetName}`\n          : `${quoteSheetName(sheetName)}!${anchor.type === 'sheet_cell' ? anchor.cell : anchor.range}`;\n    }\n    if (isExcerptOnlyAnchor(anchor)) {\n      return truncate(excerpt, LONG_EXCERPT_CHARS);\n    }\n    return `${anchorPart}: ${truncate(excerpt, LONG_EXCERPT_CHARS)}`;\n  }\n  if (\n    sheetName &&\n    (anchor.type === 'sheet_cell' || anchor.type === 'sheet_range' || anchor.type === 'sheet_tab')\n  ) {\n    if (anchor.type === 'sheet_tab') {\n      return `Sheet tab · ${sheetName}`;\n    }\n    return `${quoteSheetName(sheetName)}!${anchor.type === 'sheet_cell' ? anchor.cell : anchor.range}`;\n  }\n  return formatAnchorLong(anchor);\n}\n\n/**\n * Format an anchor into a human-readable citation line.\n *\n *   `short` — compact: p.5, L42, 1:30, §, …\n *   `long`  — expanded: Page 5, Lines 10–25, …\n *\n * Pass `meta` when available for excerpt and sheetName context.\n * Returns `null` only if the formatted string is empty.\n */\nexport function formatReferenceAnchor(\n  anchor: Anchor,\n  mode: ReferenceAnchorFormatMode = 'long',\n  meta?: AssetMeta\n): string | null {\n  const text = mode === 'short' ? formatShort(anchor, meta) : formatLong(anchor, meta);\n  return text === '' ? null : text;\n}\n"],"names":["sheetName","quoteSheetName"],"mappings":";;;AAeA,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB;AAM3B,SAAS,iBAAiB,WAA2B;AACnD,QAAM,QAAQ,UAAU,MAAM,GAAG;AACjC,MAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,QAAM,CAAC,OAAO,SAAS,OAAO,IAAI,MAAM,IAAI,CAAC,SAAS,OAAO,SAAS,MAAM,EAAE,CAAC;AAC/E,MACE,CAAC,OAAO,SAAS,OAAO,EAAE,KAAK,CAAC,SAAS,OAAO,MAAM,IAAI,CAAC,KAC3D,QAAQ,KACR,UAAU,KACV,WAAW,MACX,UAAU,KACV,WAAW,IACX;AACA,WAAO;AAAA,EACT;AACA,QAAM,gBAAgB,QAAQ,SAAA,EAAW,SAAS,GAAG,GAAG;AACxD,MAAI,QAAQ,EAAG,QAAO,GAAG,KAAK,IAAI,QAAQ,SAAA,EAAW,SAAS,GAAG,GAAG,CAAC,IAAI,aAAa;AACtF,SAAO,GAAG,OAAO,IAAI,aAAa;AACpC;AAGA,SAAS,UAAU,QAA2C;AAC5D,SAAO,OAAO,cAAc,OAAO,SAAS,OAAO,UAAU,KAAK;AACpE;AAEA,SAAS,SAAS,MAAc,KAAqB;AACnD,MAAI,KAAK,UAAU,IAAK,QAAO;AAC/B,SAAO,GAAG,KAAK,MAAM,GAAG,GAAG,CAAC;AAC9B;AAOA,SAAS,oBAAoB,QAA6B,MAAyC;AACjG,QAAM,OAAO,SAAS,UAAW,OAAO,KAAK,MAAM,GAAG,EAAE,IAAA,KAAS,OAAO,OAAQ,OAAO;AACvF,QAAM,QACJ,OAAO,cAAc,OAAO,UACxB,GAAG,OAAO,SAAS,KACnB,GAAG,OAAO,SAAS,IAAI,OAAO,OAAO;AAC3C,SAAO,GAAG,IAAI,IAAI,KAAK;AACzB;AAEA,SAAS,kBAAkB,QAAwB;AACjD,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK;AACH,aAAO,QAAQ,SAAS,OAAO,QAAQ,mBAAmB,CAAC;AAAA,IAC7D,KAAK;AACH,aAAO,SAAS,SAAS,OAAO,aAAa,mBAAmB,CAAC,MAAM,SAAS,OAAO,WAAW,mBAAmB,CAAC;AAAA,IACxH,KAAK;AACH,aAAO,oBAAoB,QAAQ,OAAO;AAAA,IAC5C,KAAK;AACH,aAAO,IAAI,OAAO,IAAI;AAAA,IACxB,KAAK;AACH,aAAO,IAAI,OAAO,SAAS,IAAI,OAAO,OAAO;AAAA,IAC/C,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,IAAI,OAAO,KAAK;AAAA,IACzB,KAAK;AACH,aAAO,SAAS,OAAO,SAAS,mBAAmB;AAAA,IACrD,KAAK;AACH,aAAO,SAAS,OAAO,MAAM,mBAAmB;AAAA,IAClD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,KAAK,OAAO,IAAI;AAAA,IACzB,KAAK;AACH,aAAO,KAAK,OAAO,SAAS,IAAI,OAAO,OAAO;AAAA,IAChD,KAAK;AACH,aAAO,KAAK,OAAO,IAAI;AAAA,IACzB,KAAK;AACH,aAAO,KAAK,OAAO,IAAI;AAAA,IACzB,KAAK;AACH,aAAO,OAAO,QAAQ,OAClB,GAAG,SAAS,OAAO,MAAM,mBAAmB,CAAC,IAAI,OAAO,IAAI,KAC5D,SAAS,OAAO,MAAM,mBAAmB;AAAA,IAC/C,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK,SAAS;AACZ,YAAM,IAAI,OAAO,SAAS;AAC1B,aAAO,MAAM,IAAI,GAAG,UAAU,MAAM,CAAC,aAAa,GAAG,UAAU,MAAM,CAAC,MAAM,CAAC;AAAA,IAC/E;AAAA,IACA,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO,OAAO;AAAA,IAChB,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,UAAU,MAAM;AAAA,IACzB,KAAK;AACH,aAAO,OAAO,QAAQ,UAAU,SAAS,OAAO,OAAO,mBAAmB,CAAC,KAAK;AAAA,IAClF,KAAK;AACH,aAAO,OAAO,QAAQ,SAAS,SAAS,OAAO,OAAO,mBAAmB,CAAC,KAAK;AAAA,IACjF,KAAK;AACH,aAAO,iBAAiB,OAAO,IAAI;AAAA,IACrC,KAAK;AACH,aAAO,GAAG,iBAAiB,OAAO,SAAS,CAAC,IAAI,iBAAiB,OAAO,OAAO,CAAC;AAAA,IAClF,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EAAA;AAEb;AAEA,SAAS,iBAAiB,QAAwB;AAChD,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK;AACH,aAAO,QAAQ,SAAS,OAAO,QAAQ,kBAAkB,CAAC;AAAA,IAC5D,KAAK;AACH,aAAO,SAAS,SAAS,OAAO,aAAa,kBAAkB,CAAC,IAAI,SAAS,OAAO,WAAW,kBAAkB,CAAC;AAAA,IACpH,KAAK;AACH,aAAO,oBAAoB,QAAQ,MAAM;AAAA,IAC3C,KAAK;AACH,aAAO,QAAQ,OAAO,IAAI;AAAA,IAC5B,KAAK;AACH,aAAO,SAAS,OAAO,SAAS,IAAI,OAAO,OAAO;AAAA,IACpD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,iBAAiB,OAAO,KAAK;AAAA,IACtC,KAAK;AACH,aAAO,aAAa,OAAO,OAAO;AAAA,IACpC,KAAK;AACH,aAAO,SAAS,OAAO,MAAM,kBAAkB;AAAA,IACjD,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,QAAQ,OAAO,IAAI;AAAA,IAC5B,KAAK;AACH,aAAO,SAAS,OAAO,SAAS,IAAI,OAAO,OAAO;AAAA,IACpD,KAAK;AACH,aAAO,QAAQ,OAAO,IAAI;AAAA,IAC5B,KAAK;AACH,aAAO,QAAQ,OAAO,IAAI;AAAA,IAC5B,KAAK;AACH,aAAO,OAAO,QAAQ,OAClB,GAAG,OAAO,IAAI,IAAI,OAAO,IAAI,GAAG,OAAO,UAAU,OAAO,IAAI,OAAO,MAAM,KAAK,EAAE,KAChF,OAAO;AAAA,IACb,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK,SAAS;AACZ,YAAM,IAAI,OAAO,SAAS;AAC1B,aAAO,MAAM,IAAI,GAAG,UAAU,MAAM,CAAC,eAAe,GAAG,UAAU,MAAM,CAAC,MAAM,CAAC;AAAA,IACjF;AAAA,IACA,KAAK;AACH,aAAO,QAAQ,OAAO,IAAI;AAAA,IAC5B,KAAK;AACH,aAAO,SAAS,OAAO,KAAK;AAAA,IAC9B,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO,UAAU,MAAM;AAAA,IACzB,KAAK;AACH,aAAO,OAAO,QACV,gBAAgB,SAAS,OAAO,OAAO,kBAAkB,CAAC,KAC1D;AAAA,IACN,KAAK;AACH,aAAO,OAAO,QACV,eAAe,SAAS,OAAO,OAAO,kBAAkB,CAAC,KACzD;AAAA,IACN,KAAK;AACH,aAAO,iBAAiB,OAAO,IAAI;AAAA,IACrC,KAAK;AACH,aAAO,GAAG,iBAAiB,OAAO,SAAS,CAAC,MAAM,iBAAiB,OAAO,OAAO,CAAC;AAAA,IACpF,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO;AAAA,EAAA;AAEb;AAGA,SAAS,oBAAoB,QAAyB;AACpD,SACE,OAAO,SAAS,aAChB,OAAO,SAAS,mBAChB,OAAO,SAAS,aAChB,OAAO,SAAS;AAEpB;AAEA,SAAS,cAAc,EAAE,QAAQ,QAAkE;AACjG,MAAI,OAAO,SAAS,YAAa,QAAO,OAAO;AAC/C,MAAI,OAAO,SAAS,WAAY,SAAO,6BAAM,YAAW,OAAO;AAC/D,SAAO,6BAAM;AACf;AAEA,SAAS,YAAY,QAAgB,MAA0B;AAC7D,QAAM,UAAU,cAAc,EAAE,QAAQ,MAAM;AAC9C,QAAMA,cAAY,6BAAM;AAExB,MAAI,SAAS;AACX,UAAM,aAAa,kBAAkB,MAAM;AAC3C,QAAI,oBAAoB,MAAM,GAAG;AAC/B,aAAO,SAAS,SAAS,mBAAmB;AAAA,IAC9C;AACA,QACEA,gBACC,OAAO,SAAS,gBAAgB,OAAO,SAAS,iBAAiB,OAAO,SAAS,cAClF;AACA,aAAO,OAAO,SAAS,cAAcA,cAAY,GAAGC,UAAAA,eAAeD,WAAS,CAAC,IAAI,UAAU;AAAA,IAC7F;AACA,WAAO;AAAA,EACT;AACA,MACEA,gBACC,OAAO,SAAS,gBAAgB,OAAO,SAAS,iBAAiB,OAAO,SAAS,cAClF;AACA,WAAO,OAAO,SAAS,cACnBA,cACA,GAAGC,yBAAeD,WAAS,CAAC,IAAI,kBAAkB,MAAM,CAAC;AAAA,EAC/D;AACA,SAAO,kBAAkB,MAAM;AACjC;AAEA,SAAS,WAAW,QAAgB,MAA0B;AAC5D,QAAM,UAAU,cAAc,EAAE,QAAQ,MAAM;AAC9C,QAAMA,cAAY,6BAAM;AAExB,MAAI,SAAS;AACX,QAAI,aAAa,iBAAiB,MAAM;AACxC,QACEA,gBACC,OAAO,SAAS,gBAAgB,OAAO,SAAS,iBAAiB,OAAO,SAAS,cAClF;AACA,mBACE,OAAO,SAAS,cACZ,eAAeA,WAAS,KACxB,GAAGC,UAAAA,eAAeD,WAAS,CAAC,IAAI,OAAO,SAAS,eAAe,OAAO,OAAO,OAAO,KAAK;AAAA,IACjG;AACA,QAAI,oBAAoB,MAAM,GAAG;AAC/B,aAAO,SAAS,SAAS,kBAAkB;AAAA,IAC7C;AACA,WAAO,GAAG,UAAU,KAAK,SAAS,SAAS,kBAAkB,CAAC;AAAA,EAChE;AACA,MACEA,gBACC,OAAO,SAAS,gBAAgB,OAAO,SAAS,iBAAiB,OAAO,SAAS,cAClF;AACA,QAAI,OAAO,SAAS,aAAa;AAC/B,aAAO,eAAeA,WAAS;AAAA,IACjC;AACA,WAAO,GAAGC,UAAAA,eAAeD,WAAS,CAAC,IAAI,OAAO,SAAS,eAAe,OAAO,OAAO,OAAO,KAAK;AAAA,EAClG;AACA,SAAO,iBAAiB,MAAM;AAChC;AAWO,SAAS,sBACd,QACA,OAAkC,QAClC,MACe;AACf,QAAM,OAAO,SAAS,UAAU,YAAY,QAAQ,IAAI,IAAI,WAAW,QAAQ,IAAI;AACnF,SAAO,SAAS,KAAK,OAAO;AAC9B;;"}

package/dist/references/src/anchors/format.js

@@ -0,0 +1,219 @@
+import { quoteSheetName } from "../sheet-name.js";
+const SHORT_EXCERPT_CHARS = 8;
+const LONG_EXCERPT_CHARS = 20;
+function formatAnchorTime(timestamp) {
+  const parts = timestamp.split(":");
+  if (parts.length !== 3) return timestamp;
+  const [hours, minutes, seconds] = parts.map((part) => Number.parseInt(part, 10));
+  if ([hours, minutes, seconds].some((part) => Number.isNaN(part)) || hours < 0 || minutes < 0 || minutes >= 60 || seconds < 0 || seconds >= 60) {
+    return timestamp;
+  }
+  const paddedSeconds = seconds.toString().padStart(2, "0");
+  if (hours > 0) return `${hours}:${minutes.toString().padStart(2, "0")}:${paddedSeconds}`;
+  return `${minutes}:${paddedSeconds}`;
+}
+function slideName(anchor) {
+  return anchor.slideIndex != null ? `Slide ${anchor.slideIndex}` : "Slide";
+}
+function truncate(text, max) {
+  if (text.length <= max) return text;
+  return `${text.slice(0, max)}…`;
+}
+function formatFileLineRange(anchor, mode) {
+  const path = mode === "short" ? anchor.path.split("/").pop() ?? anchor.path : anchor.path;
+  const lines = anchor.startLine === anchor.endLine ? `${anchor.startLine}` : `${anchor.startLine}-${anchor.endLine}`;
+  return `${path}:${lines}`;
+}
+function formatAnchorShort(anchor) {
+  switch (anchor.type) {
+    case "cell":
+      return `cell ${truncate(anchor.cellId, SHORT_EXCERPT_CHARS)}`;
+    case "cell_range":
+      return `cells ${truncate(anchor.startCellId, SHORT_EXCERPT_CHARS)} - ${truncate(anchor.endCellId, SHORT_EXCERPT_CHARS)}`;
+    case "file_line_range":
+      return formatFileLineRange(anchor, "short");
+    case "line":
+      return `L${anchor.line}`;
+    case "line_range":
+      return `L${anchor.startLine}-${anchor.endLine}`;
+    case "msg":
+      return "Msg";
+    case "msg_range":
+      return "Msgs";
+    case "msg_block":
+      return `¶${anchor.block}`;
+    case "msg_section":
+      return truncate(anchor.heading, SHORT_EXCERPT_CHARS);
+    case "msg_text":
+      return truncate(anchor.text, SHORT_EXCERPT_CHARS);
+    case "tool_call":
+      return "Tool call";
+    case "page":
+      return `p.${anchor.page}`;
+    case "page_range":
+      return `p.${anchor.startPage}-${anchor.endPage}`;
+    case "page_rect":
+      return `p.${anchor.page} (Region)`;
+    case "page_text":
+      return `p.${anchor.page}`;
+    case "path":
+      return anchor.line != null ? `${truncate(anchor.path, SHORT_EXCERPT_CHARS)}:${anchor.line}` : truncate(anchor.path, SHORT_EXCERPT_CHARS);
+    case "pm_node":
+    case "pm_node_range":
+    case "pm_mark":
+      return "§";
+    case "pixel_range":
+      return "Region";
+    case "rect":
+      return "Region";
+    case "shape": {
+      const n = anchor.shapeIds.length;
+      return n === 1 ? `${slideName(anchor)} • shape` : `${slideName(anchor)} • ${n} shapes`;
+    }
+    case "sheet_cell":
+      return anchor.cell;
+    case "sheet_range":
+      return anchor.range;
+    case "sheet_tab":
+      return "Sheet tab";
+    case "slide":
+      return slideName(anchor);
+    case "semantic_query":
+      return anchor.field ? `Cube · ${truncate(anchor.field, SHORT_EXCERPT_CHARS)}` : "Cube query";
+    case "sql_query":
+      return anchor.field ? `SQL · ${truncate(anchor.field, SHORT_EXCERPT_CHARS)}` : "SQL query";
+    case "time":
+      return formatAnchorTime(anchor.time);
+    case "time_range":
+      return `${formatAnchorTime(anchor.startTime)}-${formatAnchorTime(anchor.endTime)}`;
+    case "comment":
+    case "comment_thread":
+      return "💬";
+    default:
+      return "•";
+  }
+}
+function formatAnchorLong(anchor) {
+  switch (anchor.type) {
+    case "cell":
+      return `Cell ${truncate(anchor.cellId, LONG_EXCERPT_CHARS)}`;
+    case "cell_range":
+      return `Cells ${truncate(anchor.startCellId, LONG_EXCERPT_CHARS)}–${truncate(anchor.endCellId, LONG_EXCERPT_CHARS)}`;
+    case "file_line_range":
+      return formatFileLineRange(anchor, "long");
+    case "line":
+      return `Line ${anchor.line}`;
+    case "line_range":
+      return `Lines ${anchor.startLine}–${anchor.endLine}`;
+    case "msg":
+      return "Message";
+    case "msg_range":
+      return "Messages";
+    case "msg_block":
+      return `Message block ${anchor.block}`;
+    case "msg_section":
+      return `Section · ${anchor.heading}`;
+    case "msg_text":
+      return truncate(anchor.text, LONG_EXCERPT_CHARS);
+    case "tool_call":
+      return "Tool call";
+    case "page":
+      return `Page ${anchor.page}`;
+    case "page_range":
+      return `Pages ${anchor.startPage}–${anchor.endPage}`;
+    case "page_rect":
+      return `Page ${anchor.page} (Region)`;
+    case "page_text":
+      return `Page ${anchor.page}`;
+    case "path":
+      return anchor.line != null ? `${anchor.path}:${anchor.line}${anchor.column != null ? `:${anchor.column}` : ""}` : anchor.path;
+    case "pm_node":
+    case "pm_node_range":
+    case "pm_mark":
+      return "§";
+    case "pixel_range":
+      return "Region";
+    case "rect":
+      return "Region";
+    case "shape": {
+      const n = anchor.shapeIds.length;
+      return n === 1 ? `${slideName(anchor)} — 1 shape` : `${slideName(anchor)} — ${n} shapes`;
+    }
+    case "sheet_cell":
+      return `Cell ${anchor.cell}`;
+    case "sheet_range":
+      return `Range ${anchor.range}`;
+    case "sheet_tab":
+      return "Sheet tab";
+    case "slide":
+      return slideName(anchor);
+    case "semantic_query":
+      return anchor.field ? `Cube query · ${truncate(anchor.field, LONG_EXCERPT_CHARS)}` : "Cube query";
+    case "sql_query":
+      return anchor.field ? `SQL query · ${truncate(anchor.field, LONG_EXCERPT_CHARS)}` : "SQL query";
+    case "time":
+      return formatAnchorTime(anchor.time);
+    case "time_range":
+      return `${formatAnchorTime(anchor.startTime)} – ${formatAnchorTime(anchor.endTime)}`;
+    case "comment":
+    case "comment_thread":
+      return "Comment";
+    default:
+      return "";
+  }
+}
+function isExcerptOnlyAnchor(anchor) {
+  return anchor.type === "pm_node" || anchor.type === "pm_node_range" || anchor.type === "pm_mark" || anchor.type === "msg_text";
+}
+function anchorExcerpt({ anchor, meta }) {
+  if (anchor.type === "page_text") return anchor.text;
+  if (anchor.type === "msg_text") return (meta == null ? void 0 : meta.excerpt) || anchor.text;
+  return meta == null ? void 0 : meta.excerpt;
+}
+function formatShort(anchor, meta) {
+  const excerpt = anchorExcerpt({ anchor, meta });
+  const sheetName = meta == null ? void 0 : meta.sheetName;
+  if (excerpt) {
+    const anchorPart = formatAnchorShort(anchor);
+    if (isExcerptOnlyAnchor(anchor)) {
+      return truncate(excerpt, SHORT_EXCERPT_CHARS);
+    }
+    if (sheetName && (anchor.type === "sheet_cell" || anchor.type === "sheet_range" || anchor.type === "sheet_tab")) {
+      return anchor.type === "sheet_tab" ? sheetName : `${quoteSheetName(sheetName)}!${anchorPart}`;
+    }
+    return anchorPart;
+  }
+  if (sheetName && (anchor.type === "sheet_cell" || anchor.type === "sheet_range" || anchor.type === "sheet_tab")) {
+    return anchor.type === "sheet_tab" ? sheetName : `${quoteSheetName(sheetName)}!${formatAnchorShort(anchor)}`;
+  }
+  return formatAnchorShort(anchor);
+}
+function formatLong(anchor, meta) {
+  const excerpt = anchorExcerpt({ anchor, meta });
+  const sheetName = meta == null ? void 0 : meta.sheetName;
+  if (excerpt) {
+    let anchorPart = formatAnchorLong(anchor);
+    if (sheetName && (anchor.type === "sheet_cell" || anchor.type === "sheet_range" || anchor.type === "sheet_tab")) {
+      anchorPart = anchor.type === "sheet_tab" ? `Sheet tab · ${sheetName}` : `${quoteSheetName(sheetName)}!${anchor.type === "sheet_cell" ? anchor.cell : anchor.range}`;
+    }
+    if (isExcerptOnlyAnchor(anchor)) {
+      return truncate(excerpt, LONG_EXCERPT_CHARS);
+    }
+    return `${anchorPart}: ${truncate(excerpt, LONG_EXCERPT_CHARS)}`;
+  }
+  if (sheetName && (anchor.type === "sheet_cell" || anchor.type === "sheet_range" || anchor.type === "sheet_tab")) {
+    if (anchor.type === "sheet_tab") {
+      return `Sheet tab · ${sheetName}`;
+    }
+    return `${quoteSheetName(sheetName)}!${anchor.type === "sheet_cell" ? anchor.cell : anchor.range}`;
+  }
+  return formatAnchorLong(anchor);
+}
+function formatReferenceAnchor(anchor, mode = "long", meta) {
+  const text = mode === "short" ? formatShort(anchor, meta) : formatLong(anchor, meta);
+  return text === "" ? null : text;
+}
+export {
+  formatReferenceAnchor
+};
+//# sourceMappingURL=format.js.map

package/dist/references/src/anchors/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sources":["../../../../../references/src/anchors/format.ts"],"sourcesContent":["/**\n * `formatReferenceAnchor` — format an anchor into a human-readable citation line.\n *\n * Accepts the `Anchor` directly (+ optional `AssetMeta` for excerpt / sheetName context).\n * Returns `null` when there is nothing to format. Every renderer of a citation\n * chip labels its anchor with it: Olympus's mention chips and the\n * `@athenaintel/react` SDK's chat chips (through `@athenaintel/references/asset-links`).\n */\n\nimport { quoteSheetName } from '../sheet-name';\nimport type { AssetMeta } from '../types';\nimport type { Anchor, FileLineRangeAnchor, ShapeAnchor, SlideAnchor } from './types';\n\nexport type ReferenceAnchorFormatMode = 'short' | 'long';\n\nconst SHORT_EXCERPT_CHARS = 8;\nconst LONG_EXCERPT_CHARS = 20;\n\n/**\n * A stored `HH:MM:SS` time anchor as a reader sees it (`00:05:30` → `5:30`,\n * `01:05:30` → `1:05:30`); anything else is shown as written.\n */\nfunction formatAnchorTime(timestamp: string): string {\n  const parts = timestamp.split(':');\n  if (parts.length !== 3) return timestamp;\n  const [hours, minutes, seconds] = parts.map((part) => Number.parseInt(part, 10));\n  if (\n    [hours, minutes, seconds].some((part) => Number.isNaN(part)) ||\n    hours < 0 ||\n    minutes < 0 ||\n    minutes >= 60 ||\n    seconds < 0 ||\n    seconds >= 60\n  ) {\n    return timestamp;\n  }\n  const paddedSeconds = seconds.toString().padStart(2, '0');\n  if (hours > 0) return `${hours}:${minutes.toString().padStart(2, '0')}:${paddedSeconds}`;\n  return `${minutes}:${paddedSeconds}`;\n}\n\n/** `Slide N` by its 1-based display position; a slide cited by id alone is just `Slide`. */\nfunction slideName(anchor: SlideAnchor | ShapeAnchor): string {\n  return anchor.slideIndex != null ? `Slide ${anchor.slideIndex}` : 'Slide';\n}\n\nfunction truncate(text: string, max: number): string {\n  if (text.length <= max) return text;\n  return `${text.slice(0, max)}…`;\n}\n\n/**\n * `path:startLine-endLine`, or `path:startLine` when the range is one line.\n * The short form names the file by its basename (`indexer.py:10-42`); a path\n * is never head-truncated, which would cut off the part that identifies it.\n */\nfunction formatFileLineRange(anchor: FileLineRangeAnchor, mode: ReferenceAnchorFormatMode): string {\n  const path = mode === 'short' ? (anchor.path.split('/').pop() ?? anchor.path) : anchor.path;\n  const lines =\n    anchor.startLine === anchor.endLine\n      ? `${anchor.startLine}`\n      : `${anchor.startLine}-${anchor.endLine}`;\n  return `${path}:${lines}`;\n}\n\nfunction formatAnchorShort(anchor: Anchor): string {\n  switch (anchor.type) {\n    case 'cell':\n      return `cell ${truncate(anchor.cellId, SHORT_EXCERPT_CHARS)}`;\n    case 'cell_range':\n      return `cells ${truncate(anchor.startCellId, SHORT_EXCERPT_CHARS)} - ${truncate(anchor.endCellId, SHORT_EXCERPT_CHARS)}`;\n    case 'file_line_range':\n      return formatFileLineRange(anchor, 'short');\n    case 'line':\n      return `L${anchor.line}`;\n    case 'line_range':\n      return `L${anchor.startLine}-${anchor.endLine}`;\n    case 'msg':\n      return 'Msg';\n    case 'msg_range':\n      return 'Msgs';\n    case 'msg_block':\n      return `¶${anchor.block}`;\n    case 'msg_section':\n      return truncate(anchor.heading, SHORT_EXCERPT_CHARS);\n    case 'msg_text':\n      return truncate(anchor.text, SHORT_EXCERPT_CHARS);\n    case 'tool_call':\n      return 'Tool call';\n    case 'page':\n      return `p.${anchor.page}`;\n    case 'page_range':\n      return `p.${anchor.startPage}-${anchor.endPage}`;\n    case 'page_rect':\n      return `p.${anchor.page} (Region)`;\n    case 'page_text':\n      return `p.${anchor.page}`;\n    case 'path':\n      return anchor.line != null\n        ? `${truncate(anchor.path, SHORT_EXCERPT_CHARS)}:${anchor.line}`\n        : truncate(anchor.path, SHORT_EXCERPT_CHARS);\n    case 'pm_node':\n    case 'pm_node_range':\n    case 'pm_mark':\n      return '§';\n    case 'pixel_range':\n      return 'Region';\n    case 'rect':\n      return 'Region';\n    case 'shape': {\n      const n = anchor.shapeIds.length;\n      return n === 1 ? `${slideName(anchor)} • shape` : `${slideName(anchor)} • ${n} shapes`;\n    }\n    case 'sheet_cell':\n      return anchor.cell;\n    case 'sheet_range':\n      return anchor.range;\n    case 'sheet_tab':\n      return 'Sheet tab';\n    case 'slide':\n      return slideName(anchor);\n    case 'semantic_query':\n      return anchor.field ? `Cube · ${truncate(anchor.field, SHORT_EXCERPT_CHARS)}` : 'Cube query';\n    case 'sql_query':\n      return anchor.field ? `SQL · ${truncate(anchor.field, SHORT_EXCERPT_CHARS)}` : 'SQL query';\n    case 'time':\n      return formatAnchorTime(anchor.time);\n    case 'time_range':\n      return `${formatAnchorTime(anchor.startTime)}-${formatAnchorTime(anchor.endTime)}`;\n    case 'comment':\n    case 'comment_thread':\n      return '💬';\n    default:\n      return '•';\n  }\n}\n\nfunction formatAnchorLong(anchor: Anchor): string {\n  switch (anchor.type) {\n    case 'cell':\n      return `Cell ${truncate(anchor.cellId, LONG_EXCERPT_CHARS)}`;\n    case 'cell_range':\n      return `Cells ${truncate(anchor.startCellId, LONG_EXCERPT_CHARS)}–${truncate(anchor.endCellId, LONG_EXCERPT_CHARS)}`;\n    case 'file_line_range':\n      return formatFileLineRange(anchor, 'long');\n    case 'line':\n      return `Line ${anchor.line}`;\n    case 'line_range':\n      return `Lines ${anchor.startLine}–${anchor.endLine}`;\n    case 'msg':\n      return 'Message';\n    case 'msg_range':\n      return 'Messages';\n    case 'msg_block':\n      return `Message block ${anchor.block}`;\n    case 'msg_section':\n      return `Section · ${anchor.heading}`;\n    case 'msg_text':\n      return truncate(anchor.text, LONG_EXCERPT_CHARS);\n    case 'tool_call':\n      return 'Tool call';\n    case 'page':\n      return `Page ${anchor.page}`;\n    case 'page_range':\n      return `Pages ${anchor.startPage}–${anchor.endPage}`;\n    case 'page_rect':\n      return `Page ${anchor.page} (Region)`;\n    case 'page_text':\n      return `Page ${anchor.page}`;\n    case 'path':\n      return anchor.line != null\n        ? `${anchor.path}:${anchor.line}${anchor.column != null ? `:${anchor.column}` : ''}`\n        : anchor.path;\n    case 'pm_node':\n    case 'pm_node_range':\n    case 'pm_mark':\n      return '§';\n    case 'pixel_range':\n      return 'Region';\n    case 'rect':\n      return 'Region';\n    case 'shape': {\n      const n = anchor.shapeIds.length;\n      return n === 1 ? `${slideName(anchor)} — 1 shape` : `${slideName(anchor)} — ${n} shapes`;\n    }\n    case 'sheet_cell':\n      return `Cell ${anchor.cell}`;\n    case 'sheet_range':\n      return `Range ${anchor.range}`;\n    case 'sheet_tab':\n      return 'Sheet tab';\n    case 'slide':\n      return slideName(anchor);\n    case 'semantic_query':\n      return anchor.field\n        ? `Cube query · ${truncate(anchor.field, LONG_EXCERPT_CHARS)}`\n        : 'Cube query';\n    case 'sql_query':\n      return anchor.field\n        ? `SQL query · ${truncate(anchor.field, LONG_EXCERPT_CHARS)}`\n        : 'SQL query';\n    case 'time':\n      return formatAnchorTime(anchor.time);\n    case 'time_range':\n      return `${formatAnchorTime(anchor.startTime)} – ${formatAnchorTime(anchor.endTime)}`;\n    case 'comment':\n    case 'comment_thread':\n      return 'Comment';\n    default:\n      return '';\n  }\n}\n\n/** Anchors whose excerpt *is* the label — the location alone says nothing to a reader. */\nfunction isExcerptOnlyAnchor(anchor: Anchor): boolean {\n  return (\n    anchor.type === 'pm_node' ||\n    anchor.type === 'pm_node_range' ||\n    anchor.type === 'pm_mark' ||\n    anchor.type === 'msg_text'\n  );\n}\n\nfunction anchorExcerpt({ anchor, meta }: { anchor: Anchor; meta?: AssetMeta }): string | undefined {\n  if (anchor.type === 'page_text') return anchor.text;\n  if (anchor.type === 'msg_text') return meta?.excerpt || anchor.text;\n  return meta?.excerpt;\n}\n\nfunction formatShort(anchor: Anchor, meta?: AssetMeta): string {\n  const excerpt = anchorExcerpt({ anchor, meta });\n  const sheetName = meta?.sheetName;\n\n  if (excerpt) {\n    const anchorPart = formatAnchorShort(anchor);\n    if (isExcerptOnlyAnchor(anchor)) {\n      return truncate(excerpt, SHORT_EXCERPT_CHARS);\n    }\n    if (\n      sheetName &&\n      (anchor.type === 'sheet_cell' || anchor.type === 'sheet_range' || anchor.type === 'sheet_tab')\n    ) {\n      return anchor.type === 'sheet_tab' ? sheetName : `${quoteSheetName(sheetName)}!${anchorPart}`;\n    }\n    return anchorPart;\n  }\n  if (\n    sheetName &&\n    (anchor.type === 'sheet_cell' || anchor.type === 'sheet_range' || anchor.type === 'sheet_tab')\n  ) {\n    return anchor.type === 'sheet_tab'\n      ? sheetName\n      : `${quoteSheetName(sheetName)}!${formatAnchorShort(anchor)}`;\n  }\n  return formatAnchorShort(anchor);\n}\n\nfunction formatLong(anchor: Anchor, meta?: AssetMeta): string {\n  const excerpt = anchorExcerpt({ anchor, meta });\n  const sheetName = meta?.sheetName;\n\n  if (excerpt) {\n    let anchorPart = formatAnchorLong(anchor);\n    if (\n      sheetName &&\n      (anchor.type === 'sheet_cell' || anchor.type === 'sheet_range' || anchor.type === 'sheet_tab')\n    ) {\n      anchorPart =\n        anchor.type === 'sheet_tab'\n          ? `Sheet tab · ${sheetName}`\n          : `${quoteSheetName(sheetName)}!${anchor.type === 'sheet_cell' ? anchor.cell : anchor.range}`;\n    }\n    if (isExcerptOnlyAnchor(anchor)) {\n      return truncate(excerpt, LONG_EXCERPT_CHARS);\n    }\n    return `${anchorPart}: ${truncate(excerpt, LONG_EXCERPT_CHARS)}`;\n  }\n  if (\n    sheetName &&\n    (anchor.type === 'sheet_cell' || anchor.type === 'sheet_range' || anchor.type === 'sheet_tab')\n  ) {\n    if (anchor.type === 'sheet_tab') {\n      return `Sheet tab · ${sheetName}`;\n    }\n    return `${quoteSheetName(sheetName)}!${anchor.type === 'sheet_cell' ? anchor.cell : anchor.range}`;\n  }\n  return formatAnchorLong(anchor);\n}\n\n/**\n * Format an anchor into a human-readable citation line.\n *\n *   `short` — compact: p.5, L42, 1:30, §, …\n *   `long`  — expanded: Page 5, Lines 10–25, …\n *\n * Pass `meta` when available for excerpt and sheetName context.\n * Returns `null` only if the formatted string is empty.\n */\nexport function formatReferenceAnchor(\n  anchor: Anchor,\n  mode: ReferenceAnchorFormatMode = 'long',\n  meta?: AssetMeta\n): string | null {\n  const text = mode === 'short' ? formatShort(anchor, meta) : formatLong(anchor, meta);\n  return text === '' ? null : text;\n}\n"],"names":[],"mappings":"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"}