@athenaintel/react 0.40.3 → 0.41.1

package/dist/react/package.json.js

@@ -1,4 +1,4 @@
-const version = "0.40.3";
+const version = "0.41.1";
 const packageJson = {
   version
 };

package/dist/references/src/anchors/file-line-range.cjs

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const FILE_LINE_RANGE_BOUNDS = {
+  /** Longest repo-relative path, counted in Unicode code points (Python `len`). */
+  MAX_REPO_PATH_LENGTH: 1024,
+  /** Largest 1-based line number either end of the range may name. */
+  MAX_LINE_NUMBER: 1e7,
+  /** Largest canonical anchor, in UTF-8 bytes, that fits Clio's store. */
+  MAX_ANCHOR_BYTES: 2048
+};
+const LONE_SURROGATE = new RegExp("[\\uD800-\\uDBFF](?![\\uDC00-\\uDFFF])|(?<![\\uD800-\\uDBFF])[\\uDC00-\\uDFFF]");
+function repoPathProblem(path) {
+  if (path.length === 0) return "path must be non-empty";
+  if (Array.from(path).length > FILE_LINE_RANGE_BOUNDS.MAX_REPO_PATH_LENGTH) {
+    return `path must be at most ${FILE_LINE_RANGE_BOUNDS.MAX_REPO_PATH_LENGTH} characters`;
+  }
+  if (LONE_SURROGATE.test(path)) return "path must be valid UTF-8 (no lone surrogates)";
+  if (path.includes("\0")) return "path must not contain NUL";
+  if (path.startsWith("/")) return "path must be repo-relative (no leading '/')";
+  if (path.endsWith("/")) return "path must name a file (no trailing '/')";
+  for (const segment of path.split("/")) {
+    if (segment.length === 0) return "path must not contain an empty segment";
+    if (segment === "." || segment === "..") return "path must not contain '.' or '..' segments";
+  }
+  return void 0;
+}
+function pythonFormEncode(value) {
+  let out = "";
+  for (const byte of new TextEncoder().encode(value)) {
+    const unreserved = byte >= 48 && byte <= 57 || // 0-9
+    byte >= 65 && byte <= 90 || // A-Z
+    byte >= 97 && byte <= 122 || // a-z
+    byte === 45 || // -
+    byte === 46 || // .
+    byte === 95 || // _
+    byte === 126;
+    if (unreserved) {
+      out += String.fromCharCode(byte);
+    } else if (byte === 32) {
+      out += "+";
+    } else {
+      out += `%${byte.toString(16).toUpperCase().padStart(2, "0")}`;
+    }
+  }
+  return out;
+}
+function fileLineRangeAnchorByteLength(anchor) {
+  return `anchor=file_line_range&end_line=${anchor.endLine}&path=${pythonFormEncode(anchor.path)}&start_line=${anchor.startLine}`.length;
+}
+function lineNumberProblem(name, value) {
+  if (!Number.isInteger(value) || value < 1 || value > FILE_LINE_RANGE_BOUNDS.MAX_LINE_NUMBER) {
+    return `${name} must be an integer between 1 and ${FILE_LINE_RANGE_BOUNDS.MAX_LINE_NUMBER}`;
+  }
+  return void 0;
+}
+function fileLineRangeAnchorProblem(anchor) {
+  const problem = repoPathProblem(anchor.path) ?? lineNumberProblem("start_line", anchor.startLine) ?? lineNumberProblem("end_line", anchor.endLine);
+  if (problem) return problem;
+  if (anchor.endLine < anchor.startLine) return "end_line must be >= start_line";
+  const length = fileLineRangeAnchorByteLength(anchor);
+  if (length > FILE_LINE_RANGE_BOUNDS.MAX_ANCHOR_BYTES) {
+    return `the file_line_range anchor would be ${length} bytes; at most ${FILE_LINE_RANGE_BOUNDS.MAX_ANCHOR_BYTES} fit the store — shorten the path`;
+  }
+  return void 0;
+}
+exports.FILE_LINE_RANGE_BOUNDS = FILE_LINE_RANGE_BOUNDS;
+exports.fileLineRangeAnchorByteLength = fileLineRangeAnchorByteLength;
+exports.fileLineRangeAnchorProblem = fileLineRangeAnchorProblem;
+exports.repoPathProblem = repoPathProblem;
+//# sourceMappingURL=file-line-range.cjs.map

package/dist/references/src/anchors/file-line-range.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-line-range.cjs","sources":["../../../../../references/src/anchors/file-line-range.ts"],"sourcesContent":["/**\n * Validation rules for the `file_line_range` anchor — an inclusive, 1-based\n * line range of one file of a repository source (a GitHub `catalog` asset\n * whose files Clio indexes; `docs/clio/21-repository-source.md` §2.1).\n *\n * The rules mirror Clio's `LineRangeLocator` / `validate_repo_path`\n * (`clio/clio/contracts/search.py`) and agora's copy of them\n * (`agora/agora/services/clio/contracts.py`) rule for rule: the same bounds,\n * the same path grammar, and a byte cap measured on the canonical anchor Clio\n * writes — `anchor=file_line_range&end_line=<m>&path=<path>&start_line=<n>`\n * (parameters sorted), form-encoded by Python's `urllib.parse.urlencode`.\n * The builder (`serialize.ts`), the parser (`parse.ts`) and the storage-boundary\n * schema (`schemas.ts`) all read these one rules, so an anchor either fits the\n * store on every side or is refused on every side.\n *\n * Wire contract for what TypeScript emits: `serializeAnchorToParams` sorts the\n * parameters like Clio, but `URLSearchParams` percent-encodes `~` (Clio keeps\n * it) and keeps `*` (Clio writes `%2A`), so for those two characters the two\n * strings differ while decoding to the same anchor. Canonical *string*\n * equality is Clio's own concern — only Clio writes its store, and TS strings\n * never enter it; the TS side guarantees decoded-value equality (both strings\n * parse to one anchor) and a byte cap measured on Clio's encoding\n * (`fileLineRangeAnchorByteLength`).\n */\n\nexport const FILE_LINE_RANGE_BOUNDS = {\n  /** Longest repo-relative path, counted in Unicode code points (Python `len`). */\n  MAX_REPO_PATH_LENGTH: 1024,\n  /** Largest 1-based line number either end of the range may name. */\n  MAX_LINE_NUMBER: 10_000_000,\n  /** Largest canonical anchor, in UTF-8 bytes, that fits Clio's store. */\n  MAX_ANCHOR_BYTES: 2048,\n} as const;\n\n/** The fields of a `file_line_range` anchor (see `FileLineRangeAnchor` in `types.ts`). */\nexport type FileLineRangeFields = { path: string; startLine: number; endLine: number };\n\n/** A UTF-16 surrogate half without its partner — not representable as UTF-8. */\nconst LONE_SURROGATE = /[\\uD800-\\uDBFF](?![\\uDC00-\\uDFFF])|(?<![\\uD800-\\uDBFF])[\\uDC00-\\uDFFF]/;\n\n/**\n * Why `path` is not a repo-relative, `/`-separated file path, or `undefined`\n * when it is one. Rule for rule the Python `validate_repo_path`: non-empty, at\n * most `MAX_REPO_PATH_LENGTH` code points, valid UTF-8 (no lone surrogate), no\n * NUL, no leading or trailing `/`, no empty, `.` or `..` segment.\n */\nexport function repoPathProblem(path: string): string | undefined {\n  if (path.length === 0) return 'path must be non-empty';\n  if (Array.from(path).length > FILE_LINE_RANGE_BOUNDS.MAX_REPO_PATH_LENGTH) {\n    return `path must be at most ${FILE_LINE_RANGE_BOUNDS.MAX_REPO_PATH_LENGTH} characters`;\n  }\n  if (LONE_SURROGATE.test(path)) return 'path must be valid UTF-8 (no lone surrogates)';\n  if (path.includes('\\x00')) return 'path must not contain NUL';\n  if (path.startsWith('/')) return \"path must be repo-relative (no leading '/')\";\n  if (path.endsWith('/')) return \"path must name a file (no trailing '/')\";\n  for (const segment of path.split('/')) {\n    if (segment.length === 0) return 'path must not contain an empty segment';\n    if (segment === '.' || segment === '..') return \"path must not contain '.' or '..' segments\";\n  }\n  return undefined;\n}\n\n/**\n * One value as Python's `urllib.parse.urlencode` (`quote_plus`) writes it —\n * the bytes that actually sit in Clio's store. `URLSearchParams` encodes the\n * same way except for `~` (kept here, `%7E` there) and `*` (`%2A` here, kept\n * there), so the byte cap is measured with this encoder, never with\n * `URLSearchParams.toString()`.\n */\nfunction pythonFormEncode(value: string): string {\n  let out = '';\n  for (const byte of new TextEncoder().encode(value)) {\n    const unreserved =\n      (byte >= 0x30 && byte <= 0x39) || // 0-9\n      (byte >= 0x41 && byte <= 0x5a) || // A-Z\n      (byte >= 0x61 && byte <= 0x7a) || // a-z\n      byte === 0x2d || // -\n      byte === 0x2e || // .\n      byte === 0x5f || // _\n      byte === 0x7e; // ~\n    if (unreserved) {\n      out += String.fromCharCode(byte);\n    } else if (byte === 0x20) {\n      out += '+';\n    } else {\n      out += `%${byte.toString(16).toUpperCase().padStart(2, '0')}`;\n    }\n  }\n  return out;\n}\n\n/**\n * UTF-8 byte length of the canonical anchor Clio writes for these fields\n * (`anchor=file_line_range&end_line=<m>&path=<path>&start_line=<n>`, ASCII).\n * Equals `LineRangeLocator.anchor_length()` on the Python sides.\n */\nexport function fileLineRangeAnchorByteLength(anchor: FileLineRangeFields): number {\n  return `anchor=file_line_range&end_line=${anchor.endLine}&path=${pythonFormEncode(anchor.path)}&start_line=${anchor.startLine}`\n    .length;\n}\n\nfunction lineNumberProblem(name: string, value: number): string | undefined {\n  if (\n    !Number.isInteger(value) ||\n    value < 1 ||\n    value > FILE_LINE_RANGE_BOUNDS.MAX_LINE_NUMBER\n  ) {\n    return `${name} must be an integer between 1 and ${FILE_LINE_RANGE_BOUNDS.MAX_LINE_NUMBER}`;\n  }\n  return undefined;\n}\n\n/**\n * Why `anchor` is not a storable `file_line_range` anchor, or `undefined` when\n * it is one. Rule for rule the Python `LineRangeLocator`: the repo-path\n * grammar (`repoPathProblem`), both lines integers in `[1, MAX_LINE_NUMBER]`,\n * `endLine >= startLine`, and the canonical anchor at most `MAX_ANCHOR_BYTES`.\n */\nexport function fileLineRangeAnchorProblem(anchor: FileLineRangeFields): string | undefined {\n  const problem =\n    repoPathProblem(anchor.path) ??\n    lineNumberProblem('start_line', anchor.startLine) ??\n    lineNumberProblem('end_line', anchor.endLine);\n  if (problem) return problem;\n  if (anchor.endLine < anchor.startLine) return 'end_line must be >= start_line';\n  const length = fileLineRangeAnchorByteLength(anchor);\n  if (length > FILE_LINE_RANGE_BOUNDS.MAX_ANCHOR_BYTES) {\n    return `the file_line_range anchor would be ${length} bytes; at most ${FILE_LINE_RANGE_BOUNDS.MAX_ANCHOR_BYTES} fit the store — shorten the path`;\n  }\n  return undefined;\n}\n"],"names":[],"mappings":";;AAyBO,MAAM,yBAAyB;AAAA;AAAA,EAEpC,sBAAsB;AAAA;AAAA,EAEtB,iBAAiB;AAAA;AAAA,EAEjB,kBAAkB;AACpB;AAMA,MAAM,iBAAiB,WAAA,gFAAA;AAQhB,SAAS,gBAAgB,MAAkC;AAChE,MAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,MAAI,MAAM,KAAK,IAAI,EAAE,SAAS,uBAAuB,sBAAsB;AACzE,WAAO,wBAAwB,uBAAuB,oBAAoB;AAAA,EAC5E;AACA,MAAI,eAAe,KAAK,IAAI,EAAG,QAAO;AACtC,MAAI,KAAK,SAAS,IAAM,EAAG,QAAO;AAClC,MAAI,KAAK,WAAW,GAAG,EAAG,QAAO;AACjC,MAAI,KAAK,SAAS,GAAG,EAAG,QAAO;AAC/B,aAAW,WAAW,KAAK,MAAM,GAAG,GAAG;AACrC,QAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAI,YAAY,OAAO,YAAY,KAAM,QAAO;AAAA,EAClD;AACA,SAAO;AACT;AASA,SAAS,iBAAiB,OAAuB;AAC/C,MAAI,MAAM;AACV,aAAW,QAAQ,IAAI,YAAA,EAAc,OAAO,KAAK,GAAG;AAClD,UAAM,aACH,QAAQ,MAAQ,QAAQ;AAAA,IACxB,QAAQ,MAAQ,QAAQ;AAAA,IACxB,QAAQ,MAAQ,QAAQ;AAAA,IACzB,SAAS;AAAA,IACT,SAAS;AAAA,IACT,SAAS;AAAA,IACT,SAAS;AACX,QAAI,YAAY;AACd,aAAO,OAAO,aAAa,IAAI;AAAA,IACjC,WAAW,SAAS,IAAM;AACxB,aAAO;AAAA,IACT,OAAO;AACL,aAAO,IAAI,KAAK,SAAS,EAAE,EAAE,cAAc,SAAS,GAAG,GAAG,CAAC;AAAA,IAC7D;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,8BAA8B,QAAqC;AACjF,SAAO,mCAAmC,OAAO,OAAO,SAAS,iBAAiB,OAAO,IAAI,CAAC,eAAe,OAAO,SAAS,GAC1H;AACL;AAEA,SAAS,kBAAkB,MAAc,OAAmC;AAC1E,MACE,CAAC,OAAO,UAAU,KAAK,KACvB,QAAQ,KACR,QAAQ,uBAAuB,iBAC/B;AACA,WAAO,GAAG,IAAI,qCAAqC,uBAAuB,eAAe;AAAA,EAC3F;AACA,SAAO;AACT;AAQO,SAAS,2BAA2B,QAAiD;AAC1F,QAAM,UACJ,gBAAgB,OAAO,IAAI,KAC3B,kBAAkB,cAAc,OAAO,SAAS,KAChD,kBAAkB,YAAY,OAAO,OAAO;AAC9C,MAAI,QAAS,QAAO;AACpB,MAAI,OAAO,UAAU,OAAO,UAAW,QAAO;AAC9C,QAAM,SAAS,8BAA8B,MAAM;AACnD,MAAI,SAAS,uBAAuB,kBAAkB;AACpD,WAAO,uCAAuC,MAAM,mBAAmB,uBAAuB,gBAAgB;AAAA,EAChH;AACA,SAAO;AACT;;;;;"}

package/dist/references/src/anchors/file-line-range.js

@@ -0,0 +1,70 @@
+const FILE_LINE_RANGE_BOUNDS = {
+  /** Longest repo-relative path, counted in Unicode code points (Python `len`). */
+  MAX_REPO_PATH_LENGTH: 1024,
+  /** Largest 1-based line number either end of the range may name. */
+  MAX_LINE_NUMBER: 1e7,
+  /** Largest canonical anchor, in UTF-8 bytes, that fits Clio's store. */
+  MAX_ANCHOR_BYTES: 2048
+};
+const LONE_SURROGATE = new RegExp("[\\uD800-\\uDBFF](?![\\uDC00-\\uDFFF])|(?<![\\uD800-\\uDBFF])[\\uDC00-\\uDFFF]");
+function repoPathProblem(path) {
+  if (path.length === 0) return "path must be non-empty";
+  if (Array.from(path).length > FILE_LINE_RANGE_BOUNDS.MAX_REPO_PATH_LENGTH) {
+    return `path must be at most ${FILE_LINE_RANGE_BOUNDS.MAX_REPO_PATH_LENGTH} characters`;
+  }
+  if (LONE_SURROGATE.test(path)) return "path must be valid UTF-8 (no lone surrogates)";
+  if (path.includes("\0")) return "path must not contain NUL";
+  if (path.startsWith("/")) return "path must be repo-relative (no leading '/')";
+  if (path.endsWith("/")) return "path must name a file (no trailing '/')";
+  for (const segment of path.split("/")) {
+    if (segment.length === 0) return "path must not contain an empty segment";
+    if (segment === "." || segment === "..") return "path must not contain '.' or '..' segments";
+  }
+  return void 0;
+}
+function pythonFormEncode(value) {
+  let out = "";
+  for (const byte of new TextEncoder().encode(value)) {
+    const unreserved = byte >= 48 && byte <= 57 || // 0-9
+    byte >= 65 && byte <= 90 || // A-Z
+    byte >= 97 && byte <= 122 || // a-z
+    byte === 45 || // -
+    byte === 46 || // .
+    byte === 95 || // _
+    byte === 126;
+    if (unreserved) {
+      out += String.fromCharCode(byte);
+    } else if (byte === 32) {
+      out += "+";
+    } else {
+      out += `%${byte.toString(16).toUpperCase().padStart(2, "0")}`;
+    }
+  }
+  return out;
+}
+function fileLineRangeAnchorByteLength(anchor) {
+  return `anchor=file_line_range&end_line=${anchor.endLine}&path=${pythonFormEncode(anchor.path)}&start_line=${anchor.startLine}`.length;
+}
+function lineNumberProblem(name, value) {
+  if (!Number.isInteger(value) || value < 1 || value > FILE_LINE_RANGE_BOUNDS.MAX_LINE_NUMBER) {
+    return `${name} must be an integer between 1 and ${FILE_LINE_RANGE_BOUNDS.MAX_LINE_NUMBER}`;
+  }
+  return void 0;
+}
+function fileLineRangeAnchorProblem(anchor) {
+  const problem = repoPathProblem(anchor.path) ?? lineNumberProblem("start_line", anchor.startLine) ?? lineNumberProblem("end_line", anchor.endLine);
+  if (problem) return problem;
+  if (anchor.endLine < anchor.startLine) return "end_line must be >= start_line";
+  const length = fileLineRangeAnchorByteLength(anchor);
+  if (length > FILE_LINE_RANGE_BOUNDS.MAX_ANCHOR_BYTES) {
+    return `the file_line_range anchor would be ${length} bytes; at most ${FILE_LINE_RANGE_BOUNDS.MAX_ANCHOR_BYTES} fit the store — shorten the path`;
+  }
+  return void 0;
+}
+export {
+  FILE_LINE_RANGE_BOUNDS,
+  fileLineRangeAnchorByteLength,
+  fileLineRangeAnchorProblem,
+  repoPathProblem
+};
+//# sourceMappingURL=file-line-range.js.map

package/dist/references/src/anchors/file-line-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-line-range.js","sources":["../../../../../references/src/anchors/file-line-range.ts"],"sourcesContent":["/**\n * Validation rules for the `file_line_range` anchor — an inclusive, 1-based\n * line range of one file of a repository source (a GitHub `catalog` asset\n * whose files Clio indexes; `docs/clio/21-repository-source.md` §2.1).\n *\n * The rules mirror Clio's `LineRangeLocator` / `validate_repo_path`\n * (`clio/clio/contracts/search.py`) and agora's copy of them\n * (`agora/agora/services/clio/contracts.py`) rule for rule: the same bounds,\n * the same path grammar, and a byte cap measured on the canonical anchor Clio\n * writes — `anchor=file_line_range&end_line=<m>&path=<path>&start_line=<n>`\n * (parameters sorted), form-encoded by Python's `urllib.parse.urlencode`.\n * The builder (`serialize.ts`), the parser (`parse.ts`) and the storage-boundary\n * schema (`schemas.ts`) all read these one rules, so an anchor either fits the\n * store on every side or is refused on every side.\n *\n * Wire contract for what TypeScript emits: `serializeAnchorToParams` sorts the\n * parameters like Clio, but `URLSearchParams` percent-encodes `~` (Clio keeps\n * it) and keeps `*` (Clio writes `%2A`), so for those two characters the two\n * strings differ while decoding to the same anchor. Canonical *string*\n * equality is Clio's own concern — only Clio writes its store, and TS strings\n * never enter it; the TS side guarantees decoded-value equality (both strings\n * parse to one anchor) and a byte cap measured on Clio's encoding\n * (`fileLineRangeAnchorByteLength`).\n */\n\nexport const FILE_LINE_RANGE_BOUNDS = {\n  /** Longest repo-relative path, counted in Unicode code points (Python `len`). */\n  MAX_REPO_PATH_LENGTH: 1024,\n  /** Largest 1-based line number either end of the range may name. */\n  MAX_LINE_NUMBER: 10_000_000,\n  /** Largest canonical anchor, in UTF-8 bytes, that fits Clio's store. */\n  MAX_ANCHOR_BYTES: 2048,\n} as const;\n\n/** The fields of a `file_line_range` anchor (see `FileLineRangeAnchor` in `types.ts`). */\nexport type FileLineRangeFields = { path: string; startLine: number; endLine: number };\n\n/** A UTF-16 surrogate half without its partner — not representable as UTF-8. */\nconst LONE_SURROGATE = /[\\uD800-\\uDBFF](?![\\uDC00-\\uDFFF])|(?<![\\uD800-\\uDBFF])[\\uDC00-\\uDFFF]/;\n\n/**\n * Why `path` is not a repo-relative, `/`-separated file path, or `undefined`\n * when it is one. Rule for rule the Python `validate_repo_path`: non-empty, at\n * most `MAX_REPO_PATH_LENGTH` code points, valid UTF-8 (no lone surrogate), no\n * NUL, no leading or trailing `/`, no empty, `.` or `..` segment.\n */\nexport function repoPathProblem(path: string): string | undefined {\n  if (path.length === 0) return 'path must be non-empty';\n  if (Array.from(path).length > FILE_LINE_RANGE_BOUNDS.MAX_REPO_PATH_LENGTH) {\n    return `path must be at most ${FILE_LINE_RANGE_BOUNDS.MAX_REPO_PATH_LENGTH} characters`;\n  }\n  if (LONE_SURROGATE.test(path)) return 'path must be valid UTF-8 (no lone surrogates)';\n  if (path.includes('\\x00')) return 'path must not contain NUL';\n  if (path.startsWith('/')) return \"path must be repo-relative (no leading '/')\";\n  if (path.endsWith('/')) return \"path must name a file (no trailing '/')\";\n  for (const segment of path.split('/')) {\n    if (segment.length === 0) return 'path must not contain an empty segment';\n    if (segment === '.' || segment === '..') return \"path must not contain '.' or '..' segments\";\n  }\n  return undefined;\n}\n\n/**\n * One value as Python's `urllib.parse.urlencode` (`quote_plus`) writes it —\n * the bytes that actually sit in Clio's store. `URLSearchParams` encodes the\n * same way except for `~` (kept here, `%7E` there) and `*` (`%2A` here, kept\n * there), so the byte cap is measured with this encoder, never with\n * `URLSearchParams.toString()`.\n */\nfunction pythonFormEncode(value: string): string {\n  let out = '';\n  for (const byte of new TextEncoder().encode(value)) {\n    const unreserved =\n      (byte >= 0x30 && byte <= 0x39) || // 0-9\n      (byte >= 0x41 && byte <= 0x5a) || // A-Z\n      (byte >= 0x61 && byte <= 0x7a) || // a-z\n      byte === 0x2d || // -\n      byte === 0x2e || // .\n      byte === 0x5f || // _\n      byte === 0x7e; // ~\n    if (unreserved) {\n      out += String.fromCharCode(byte);\n    } else if (byte === 0x20) {\n      out += '+';\n    } else {\n      out += `%${byte.toString(16).toUpperCase().padStart(2, '0')}`;\n    }\n  }\n  return out;\n}\n\n/**\n * UTF-8 byte length of the canonical anchor Clio writes for these fields\n * (`anchor=file_line_range&end_line=<m>&path=<path>&start_line=<n>`, ASCII).\n * Equals `LineRangeLocator.anchor_length()` on the Python sides.\n */\nexport function fileLineRangeAnchorByteLength(anchor: FileLineRangeFields): number {\n  return `anchor=file_line_range&end_line=${anchor.endLine}&path=${pythonFormEncode(anchor.path)}&start_line=${anchor.startLine}`\n    .length;\n}\n\nfunction lineNumberProblem(name: string, value: number): string | undefined {\n  if (\n    !Number.isInteger(value) ||\n    value < 1 ||\n    value > FILE_LINE_RANGE_BOUNDS.MAX_LINE_NUMBER\n  ) {\n    return `${name} must be an integer between 1 and ${FILE_LINE_RANGE_BOUNDS.MAX_LINE_NUMBER}`;\n  }\n  return undefined;\n}\n\n/**\n * Why `anchor` is not a storable `file_line_range` anchor, or `undefined` when\n * it is one. Rule for rule the Python `LineRangeLocator`: the repo-path\n * grammar (`repoPathProblem`), both lines integers in `[1, MAX_LINE_NUMBER]`,\n * `endLine >= startLine`, and the canonical anchor at most `MAX_ANCHOR_BYTES`.\n */\nexport function fileLineRangeAnchorProblem(anchor: FileLineRangeFields): string | undefined {\n  const problem =\n    repoPathProblem(anchor.path) ??\n    lineNumberProblem('start_line', anchor.startLine) ??\n    lineNumberProblem('end_line', anchor.endLine);\n  if (problem) return problem;\n  if (anchor.endLine < anchor.startLine) return 'end_line must be >= start_line';\n  const length = fileLineRangeAnchorByteLength(anchor);\n  if (length > FILE_LINE_RANGE_BOUNDS.MAX_ANCHOR_BYTES) {\n    return `the file_line_range anchor would be ${length} bytes; at most ${FILE_LINE_RANGE_BOUNDS.MAX_ANCHOR_BYTES} fit the store — shorten the path`;\n  }\n  return undefined;\n}\n"],"names":[],"mappings":"AAyBO,MAAM,yBAAyB;AAAA;AAAA,EAEpC,sBAAsB;AAAA;AAAA,EAEtB,iBAAiB;AAAA;AAAA,EAEjB,kBAAkB;AACpB;AAMA,MAAM,iBAAiB,WAAA,gFAAA;AAQhB,SAAS,gBAAgB,MAAkC;AAChE,MAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,MAAI,MAAM,KAAK,IAAI,EAAE,SAAS,uBAAuB,sBAAsB;AACzE,WAAO,wBAAwB,uBAAuB,oBAAoB;AAAA,EAC5E;AACA,MAAI,eAAe,KAAK,IAAI,EAAG,QAAO;AACtC,MAAI,KAAK,SAAS,IAAM,EAAG,QAAO;AAClC,MAAI,KAAK,WAAW,GAAG,EAAG,QAAO;AACjC,MAAI,KAAK,SAAS,GAAG,EAAG,QAAO;AAC/B,aAAW,WAAW,KAAK,MAAM,GAAG,GAAG;AACrC,QAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAI,YAAY,OAAO,YAAY,KAAM,QAAO;AAAA,EAClD;AACA,SAAO;AACT;AASA,SAAS,iBAAiB,OAAuB;AAC/C,MAAI,MAAM;AACV,aAAW,QAAQ,IAAI,YAAA,EAAc,OAAO,KAAK,GAAG;AAClD,UAAM,aACH,QAAQ,MAAQ,QAAQ;AAAA,IACxB,QAAQ,MAAQ,QAAQ;AAAA,IACxB,QAAQ,MAAQ,QAAQ;AAAA,IACzB,SAAS;AAAA,IACT,SAAS;AAAA,IACT,SAAS;AAAA,IACT,SAAS;AACX,QAAI,YAAY;AACd,aAAO,OAAO,aAAa,IAAI;AAAA,IACjC,WAAW,SAAS,IAAM;AACxB,aAAO;AAAA,IACT,OAAO;AACL,aAAO,IAAI,KAAK,SAAS,EAAE,EAAE,cAAc,SAAS,GAAG,GAAG,CAAC;AAAA,IAC7D;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,8BAA8B,QAAqC;AACjF,SAAO,mCAAmC,OAAO,OAAO,SAAS,iBAAiB,OAAO,IAAI,CAAC,eAAe,OAAO,SAAS,GAC1H;AACL;AAEA,SAAS,kBAAkB,MAAc,OAAmC;AAC1E,MACE,CAAC,OAAO,UAAU,KAAK,KACvB,QAAQ,KACR,QAAQ,uBAAuB,iBAC/B;AACA,WAAO,GAAG,IAAI,qCAAqC,uBAAuB,eAAe;AAAA,EAC3F;AACA,SAAO;AACT;AAQO,SAAS,2BAA2B,QAAiD;AAC1F,QAAM,UACJ,gBAAgB,OAAO,IAAI,KAC3B,kBAAkB,cAAc,OAAO,SAAS,KAChD,kBAAkB,YAAY,OAAO,OAAO;AAC9C,MAAI,QAAS,QAAO;AACpB,MAAI,OAAO,UAAU,OAAO,UAAW,QAAO;AAC9C,QAAM,SAAS,8BAA8B,MAAM;AACnD,MAAI,SAAS,uBAAuB,kBAAkB;AACpD,WAAO,uCAAuC,MAAM,mBAAmB,uBAAuB,gBAAgB;AAAA,EAChH;AACA,SAAO;AACT;"}

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":"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"}