@mcp-z/mcp-sheets 1.0.7 → 1.1.1

package/dist/esm/spreadsheet/markdown-runs.js

@@ -0,0 +1,325 @@
+/**
+ * Inline Markdown → Google Sheets textFormatRuns
+ *
+ * The Sheets values API can only write plain text or formulas — it cannot set
+ * `textFormatRuns`, so plain-text URLs are never linkified and `=HYPERLINK()`
+ * only ever produces one link per cell. Multiple distinct clickable links (or
+ * any other rich text) inside a single cell require `textFormatRuns`, which is
+ * only settable via `spreadsheets.batchUpdate` → `updateCells`. This module
+ * parses a small, deliberately restricted subset of inline markdown into plain
+ * text plus the `textFormatRuns` needed to render it.
+ *
+ * Supported inline constructs:
+ *   - `[label](url)` and bare `http(s)://` URLs -> `format.link.uri`
+ *   - `**bold**` / `__bold__`                    -> `format.bold`
+ *   - `*italic*` / `_italic_`                     -> `format.italic`
+ *   - `~~strikethrough~~`                         -> `format.strikethrough`
+ *   - `\X` escapes any of the delimiter characters above to a literal `X`
+ *
+ * Everything else (headers, lists, tables, backticks, unmatched delimiters,
+ * ...) is passed through as literal text. This module never throws on
+ * malformed markdown — graceful degradation to literal text is the contract.
+ *
+ * A note on indices: Google Sheets `textFormatRuns[].startIndex` is defined in
+ * UTF-16 code units. JavaScript string indexing (`str[i]`, `str.length`,
+ * `str.slice()`) already operates on UTF-16 code units, so plain indexing is
+ * exactly correct here. Do NOT iterate with `[...str]` or any other code-point
+ * aware iteration — that would silently misalign indices for any text
+ * containing astral characters (e.g. emoji), which are represented as
+ * surrogate pairs (2 code units).
+ */ // Default styling applied to link runs so they read as clickable links (Sheets'
+// own link color), matching what Sheets applies automatically for =HYPERLINK().
+const LINK_BLUE = {
+    red: 0.06666667,
+    green: 0.33333334,
+    blue: 0.8
+};
+// Matched against a suffix of the input (anchored with ^), so `.exec` always tests position 0.
+const MD_LINK = /^\[([^\]]*?)\]\(\s*(<[^>]+>|[^)\s]+)(?:\s+"[^"]*")?\s*\)/;
+const BARE_URL = /^https?:\/\/[^\s<>"'()[\]]+/;
+// Characters that may be backslash-escaped to a literal (the delimiter chars this
+// parser recognizes as syntax, plus the backslash itself).
+const ESCAPABLE = new Set([
+    '\\',
+    '*',
+    '_',
+    '~',
+    '[',
+    ']',
+    '(',
+    ')'
+]);
+/** Trailing punctuation that is almost certainly prose, not part of a bare URL. */ function trimTrailingPunctuation(url) {
+    return url.replace(/[.,;:!?]+$/, '');
+}
+const isWhitespaceOrEdge = (ch)=>ch === undefined || /\s/.test(ch);
+const isWordChar = (ch)=>ch !== undefined && /[A-Za-z0-9]/.test(ch);
+/**
+ * Simplified CommonMark flanking rules — without these, whitespace-flanked
+ * delimiters pair up ("3 * 4 * 5" would italicize " 4 ") and intraword
+ * underscores become emphasis ("user_id and account_id" would italicize
+ * "id and account" and delete the underscores). Both are silent data
+ * corruption for ordinary spreadsheet content, so:
+ *   - a delimiter can OPEN emphasis only if not followed by whitespace/end
+ *   - a delimiter can CLOSE emphasis only if not preceded by whitespace/start
+ *   - `_`/`__` additionally can never open after, or close before, a word
+ *     character (intraword underscores are literal, per CommonMark)
+ * Intraword `*` is intentionally still allowed (`a*b*c` emphasizes `b`),
+ * matching CommonMark.
+ */ function delimiterFlanking(_kind, raw, prev, next) {
+    const underscore = raw.startsWith('_');
+    const canOpen = !isWhitespaceOrEdge(next) && !(underscore && isWordChar(prev));
+    const canClose = !isWhitespaceOrEdge(prev) && !(underscore && isWordChar(next));
+    return {
+        canOpen,
+        canClose
+    };
+}
+/**
+ * Scans the raw markdown left-to-right into a flat token stream: literal text
+ * runs, resolved links (markdown-link or bare-URL), and emphasis delimiters.
+ * Emphasis delimiters are emitted as opaque tokens here — whether a given
+ * delimiter is an opener, a closer, or unmatched (and thus literal) is decided
+ * in a second pass, since that requires seeing the whole stream.
+ */ function tokenize(markdown) {
+    const tokens = [];
+    let buffer = '';
+    const flush = ()=>{
+        if (buffer) {
+            tokens.push({
+                type: 'text',
+                value: buffer
+            });
+            buffer = '';
+        }
+    };
+    let i = 0;
+    while(i < markdown.length){
+        const ch = markdown[i];
+        const next = markdown[i + 1];
+        // Backslash escapes: \* \_ \~ \[ \] \( \) \\  -> literal char, never treated as syntax.
+        if (ch === '\\' && next !== undefined && ESCAPABLE.has(next)) {
+            buffer += next;
+            i += 2;
+            continue;
+        }
+        // Markdown links: [label](url) — checked before bare URLs so the label wins.
+        const linkMatch = MD_LINK.exec(markdown.slice(i));
+        if (linkMatch) {
+            var _linkMatch_, _linkMatch_1;
+            flush();
+            const rawLabel = ((_linkMatch_ = linkMatch[1]) !== null && _linkMatch_ !== void 0 ? _linkMatch_ : '').trim();
+            const uri = ((_linkMatch_1 = linkMatch[2]) !== null && _linkMatch_1 !== void 0 ? _linkMatch_1 : '').replace(/^<|>$/g, '');
+            tokens.push({
+                type: 'link',
+                label: rawLabel.length > 0 ? rawLabel : uri,
+                uri
+            });
+            i += linkMatch[0].length;
+            continue;
+        }
+        // Bare http(s) URLs — the URL itself becomes the label.
+        if (ch === 'h') {
+            const bareMatch = BARE_URL.exec(markdown.slice(i));
+            if (bareMatch) {
+                flush();
+                const raw = bareMatch[0];
+                const uri = trimTrailingPunctuation(raw);
+                tokens.push({
+                    type: 'link',
+                    label: uri,
+                    uri
+                });
+                // Trailing punctuation trimmed off the URL is not part of the link — keep it as literal text.
+                if (uri.length < raw.length) buffer += raw.slice(uri.length);
+                i += raw.length;
+                continue;
+            }
+        }
+        // Emphasis delimiters — longest first: ** and __ (bold) and ~~ (strikethrough) before * and _ (italic).
+        // The delimiter's width is fixed BEFORE the flanking check: a ** that fails
+        // flanking is two literal asterisks, never reinterpreted as two * delimiters.
+        const two = markdown.slice(i, i + 2);
+        const kind = two === '**' || two === '__' ? 'bold' : two === '~~' ? 'strikethrough' : ch === '*' || ch === '_' ? 'italic' : undefined;
+        if (kind !== undefined) {
+            const raw = kind === 'italic' ? ch : two;
+            const { canOpen, canClose } = delimiterFlanking(kind, raw, markdown[i - 1], markdown[i + raw.length]);
+            if (canOpen || canClose) {
+                flush();
+                tokens.push({
+                    type: 'delim',
+                    kind,
+                    raw,
+                    canOpen,
+                    canClose
+                });
+            } else {
+                // Fails flanking on both sides — literal text (e.g. " * " or intraword "_").
+                buffer += raw;
+            }
+            i += raw.length;
+            continue;
+        }
+        buffer += ch;
+        i += 1;
+    }
+    flush();
+    return tokens;
+}
+// ---------------------------------------------------------------------------
+// Delimiter matching (unmatched delimiters degrade to literal text)
+// ---------------------------------------------------------------------------
+/** Matches emphasis delimiter tokens by kind using a simple open/close stack (assumes well-nested markdown). */ function matchDelimiters(tokens) {
+    const stack = [];
+    const openerToCloser = new Map();
+    tokens.forEach((token, index)=>{
+        if (token.type !== 'delim') return;
+        const top = stack[stack.length - 1];
+        if (token.canClose && top && top.kind === token.kind) {
+            stack.pop();
+            openerToCloser.set(top.tokenIndex, index);
+        } else if (token.canOpen) {
+            stack.push({
+                kind: token.kind,
+                tokenIndex: index
+            });
+        }
+    // Can neither close the current context nor open — stays unmatched (literal).
+    });
+    // Anything left on the stack never closed — leave unmatched (rendered literally by the caller).
+    return openerToCloser;
+}
+const FORMAT_FOR_KIND = {
+    bold: {
+        bold: true
+    },
+    italic: {
+        italic: true
+    },
+    strikethrough: {
+        strikethrough: true
+    }
+};
+/** Walks the token stream, resolving matched delimiter pairs into spans and unmatched ones into literal text. */ function buildTextAndSpans(tokens) {
+    const openerToCloser = matchDelimiters(tokens);
+    const closerToOpener = new Map();
+    for (const [opener, closer] of openerToCloser)closerToOpener.set(closer, opener);
+    let text = '';
+    const spans = [];
+    const openerStart = new Map(); // opener token index -> plain-text start offset
+    tokens.forEach((token, index)=>{
+        if (token.type === 'text') {
+            text += token.value;
+            return;
+        }
+        if (token.type === 'link') {
+            const start = text.length;
+            text += token.label;
+            spans.push({
+                start,
+                end: text.length,
+                format: {
+                    link: {
+                        uri: token.uri
+                    }
+                }
+            });
+            return;
+        }
+        // Emphasis delimiter token.
+        if (openerToCloser.has(index)) {
+            // Matched opener — record where its span begins; the delimiter itself is consumed (not emitted).
+            openerStart.set(index, text.length);
+            return;
+        }
+        const openerIndex = closerToOpener.get(index);
+        if (openerIndex !== undefined) {
+            // Matched closer — emit the span from the recorded opener position to here.
+            const start = openerStart.get(openerIndex);
+            if (start === undefined) {
+                throw new Error('markdown-runs: internal error — emphasis opener position was not recorded');
+            }
+            spans.push({
+                start,
+                end: text.length,
+                format: FORMAT_FOR_KIND[token.kind]
+            });
+            return;
+        }
+        // Unmatched delimiter — no syntactic partner, so it degrades to its literal characters.
+        text += token.raw;
+    });
+    return {
+        text,
+        spans
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Parses inline markdown into plain text plus formatting spans (see module docs for the supported subset). */ export function parseInlineMarkdown(markdown) {
+    const tokens = tokenize(markdown);
+    const { text, spans } = buildTextAndSpans(tokens);
+    const linkCount = spans.filter((span)=>span.format.link !== undefined).length;
+    return {
+        text,
+        spans,
+        linkCount
+    };
+}
+/**
+ * Builds `textFormatRuns` from parsed markdown spans.
+ *
+ * Three Sheets API rules drive this, and are easy to get wrong:
+ *   1. A run's format persists to the end of the string unless a later run
+ *      resets it with an empty `format: {}` — runs are NOT scoped to a range.
+ *   2. A run must never be emitted at `startIndex === text.length`: a span
+ *      that reaches the end of the string needs no "turn it off" run, because
+ *      there's no text left for stray formatting to leak into.
+ *   3. Runs must be listed in strictly increasing `startIndex` order, with no
+ *      two runs sharing an index.
+ *
+ * The approach: collect every index where the set of "active" spans changes
+ * (every span start, and every span end that isn't end-of-string), merge the
+ * formats of all spans active at each such index into one run, then ensure
+ * there is a run at index 0 — either a span already starts there, or an
+ * explicit empty-format baseline is prepended so the cell doesn't inherit any
+ * pre-existing rich text formatting.
+ */ export function buildTextFormatRuns(parsed, styleLinks = true) {
+    var _runs_;
+    const { text, spans } = parsed;
+    if (text.length === 0) return [];
+    const boundaries = new Set();
+    for (const span of spans){
+        boundaries.add(span.start);
+        if (span.end < text.length) boundaries.add(span.end);
+    }
+    const sortedBoundaries = [
+        ...boundaries
+    ].sort((a, b)=>a - b);
+    const runs = sortedBoundaries.map((startIndex)=>{
+        const format = {};
+        for (const span of spans){
+            if (span.start <= startIndex && startIndex < span.end) {
+                Object.assign(format, span.format);
+            }
+        }
+        if (styleLinks && format.link) {
+            format.underline = true;
+            format.foregroundColorStyle = {
+                rgbColor: LINK_BLUE
+            };
+        }
+        return {
+            startIndex,
+            format
+        };
+    });
+    if (runs.length === 0 || ((_runs_ = runs[0]) === null || _runs_ === void 0 ? void 0 : _runs_.startIndex) !== 0) {
+        runs.unshift({
+            startIndex: 0,
+            format: {}
+        });
+    }
+    return runs;
+}

package/dist/esm/spreadsheet/markdown-runs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/markdown-runs.ts"],"sourcesContent":["/**\n * Inline Markdown → Google Sheets textFormatRuns\n *\n * The Sheets values API can only write plain text or formulas — it cannot set\n * `textFormatRuns`, so plain-text URLs are never linkified and `=HYPERLINK()`\n * only ever produces one link per cell. Multiple distinct clickable links (or\n * any other rich text) inside a single cell require `textFormatRuns`, which is\n * only settable via `spreadsheets.batchUpdate` → `updateCells`. This module\n * parses a small, deliberately restricted subset of inline markdown into plain\n * text plus the `textFormatRuns` needed to render it.\n *\n * Supported inline constructs:\n *   - `[label](url)` and bare `http(s)://` URLs -> `format.link.uri`\n *   - `**bold**` / `__bold__`                    -> `format.bold`\n *   - `*italic*` / `_italic_`                     -> `format.italic`\n *   - `~~strikethrough~~`                         -> `format.strikethrough`\n *   - `\\X` escapes any of the delimiter characters above to a literal `X`\n *\n * Everything else (headers, lists, tables, backticks, unmatched delimiters,\n * ...) is passed through as literal text. This module never throws on\n * malformed markdown — graceful degradation to literal text is the contract.\n *\n * A note on indices: Google Sheets `textFormatRuns[].startIndex` is defined in\n * UTF-16 code units. JavaScript string indexing (`str[i]`, `str.length`,\n * `str.slice()`) already operates on UTF-16 code units, so plain indexing is\n * exactly correct here. Do NOT iterate with `[...str]` or any other code-point\n * aware iteration — that would silently misalign indices for any text\n * containing astral characters (e.g. emoji), which are represented as\n * surrogate pairs (2 code units).\n */\n\nimport type { sheets_v4 } from 'googleapis';\n\n// Default styling applied to link runs so they read as clickable links (Sheets'\n// own link color), matching what Sheets applies automatically for =HYPERLINK().\nconst LINK_BLUE: sheets_v4.Schema$Color = { red: 0.06666667, green: 0.33333334, blue: 0.8 };\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/** A formatting span over `text`, in UTF-16 code unit coordinates (half-open: [start, end)). */\nexport interface MarkdownSpan {\n  start: number;\n  end: number;\n  format: sheets_v4.Schema$TextFormat;\n}\n\nexport interface ParsedMarkdown {\n  /** Plain text with all markdown syntax stripped (or literalized). */\n  text: string;\n  /** Formatting spans over `text`. May overlap/nest (e.g. a bold span wrapping a link span). */\n  spans: MarkdownSpan[];\n  /** Number of link spans found (spans whose format has `link` set). */\n  linkCount: number;\n}\n\n// ---------------------------------------------------------------------------\n// Tokenizer\n// ---------------------------------------------------------------------------\n\ntype EmphasisKind = 'bold' | 'italic' | 'strikethrough';\n\ntype Token = { type: 'text'; value: string } | { type: 'link'; label: string; uri: string } | { type: 'delim'; kind: EmphasisKind; raw: string; canOpen: boolean; canClose: boolean };\n\n// Matched against a suffix of the input (anchored with ^), so `.exec` always tests position 0.\nconst MD_LINK = /^\\[([^\\]]*?)\\]\\(\\s*(<[^>]+>|[^)\\s]+)(?:\\s+\"[^\"]*\")?\\s*\\)/;\nconst BARE_URL = /^https?:\\/\\/[^\\s<>\"'()[\\]]+/;\n\n// Characters that may be backslash-escaped to a literal (the delimiter chars this\n// parser recognizes as syntax, plus the backslash itself).\nconst ESCAPABLE = new Set(['\\\\', '*', '_', '~', '[', ']', '(', ')']);\n\n/** Trailing punctuation that is almost certainly prose, not part of a bare URL. */\nfunction trimTrailingPunctuation(url: string): string {\n  return url.replace(/[.,;:!?]+$/, '');\n}\n\nconst isWhitespaceOrEdge = (ch: string | undefined): boolean => ch === undefined || /\\s/.test(ch);\nconst isWordChar = (ch: string | undefined): boolean => ch !== undefined && /[A-Za-z0-9]/.test(ch);\n\n/**\n * Simplified CommonMark flanking rules — without these, whitespace-flanked\n * delimiters pair up (\"3 * 4 * 5\" would italicize \" 4 \") and intraword\n * underscores become emphasis (\"user_id and account_id\" would italicize\n * \"id and account\" and delete the underscores). Both are silent data\n * corruption for ordinary spreadsheet content, so:\n *   - a delimiter can OPEN emphasis only if not followed by whitespace/end\n *   - a delimiter can CLOSE emphasis only if not preceded by whitespace/start\n *   - `_`/`__` additionally can never open after, or close before, a word\n *     character (intraword underscores are literal, per CommonMark)\n * Intraword `*` is intentionally still allowed (`a*b*c` emphasizes `b`),\n * matching CommonMark.\n */\nfunction delimiterFlanking(_kind: EmphasisKind, raw: string, prev: string | undefined, next: string | undefined): { canOpen: boolean; canClose: boolean } {\n  const underscore = raw.startsWith('_');\n  const canOpen = !isWhitespaceOrEdge(next) && !(underscore && isWordChar(prev));\n  const canClose = !isWhitespaceOrEdge(prev) && !(underscore && isWordChar(next));\n  return { canOpen, canClose };\n}\n\n/**\n * Scans the raw markdown left-to-right into a flat token stream: literal text\n * runs, resolved links (markdown-link or bare-URL), and emphasis delimiters.\n * Emphasis delimiters are emitted as opaque tokens here — whether a given\n * delimiter is an opener, a closer, or unmatched (and thus literal) is decided\n * in a second pass, since that requires seeing the whole stream.\n */\nfunction tokenize(markdown: string): Token[] {\n  const tokens: Token[] = [];\n  let buffer = '';\n  const flush = () => {\n    if (buffer) {\n      tokens.push({ type: 'text', value: buffer });\n      buffer = '';\n    }\n  };\n\n  let i = 0;\n  while (i < markdown.length) {\n    const ch = markdown[i] as string;\n    const next = markdown[i + 1];\n\n    // Backslash escapes: \\* \\_ \\~ \\[ \\] \\( \\) \\\\  -> literal char, never treated as syntax.\n    if (ch === '\\\\' && next !== undefined && ESCAPABLE.has(next)) {\n      buffer += next;\n      i += 2;\n      continue;\n    }\n\n    // Markdown links: [label](url) — checked before bare URLs so the label wins.\n    const linkMatch = MD_LINK.exec(markdown.slice(i));\n    if (linkMatch) {\n      flush();\n      const rawLabel = (linkMatch[1] ?? '').trim();\n      const uri = (linkMatch[2] ?? '').replace(/^<|>$/g, '');\n      tokens.push({ type: 'link', label: rawLabel.length > 0 ? rawLabel : uri, uri });\n      i += linkMatch[0].length;\n      continue;\n    }\n\n    // Bare http(s) URLs — the URL itself becomes the label.\n    if (ch === 'h') {\n      const bareMatch = BARE_URL.exec(markdown.slice(i));\n      if (bareMatch) {\n        flush();\n        const raw = bareMatch[0];\n        const uri = trimTrailingPunctuation(raw);\n        tokens.push({ type: 'link', label: uri, uri });\n        // Trailing punctuation trimmed off the URL is not part of the link — keep it as literal text.\n        if (uri.length < raw.length) buffer += raw.slice(uri.length);\n        i += raw.length;\n        continue;\n      }\n    }\n\n    // Emphasis delimiters — longest first: ** and __ (bold) and ~~ (strikethrough) before * and _ (italic).\n    // The delimiter's width is fixed BEFORE the flanking check: a ** that fails\n    // flanking is two literal asterisks, never reinterpreted as two * delimiters.\n    const two = markdown.slice(i, i + 2);\n    const kind: EmphasisKind | undefined = two === '**' || two === '__' ? 'bold' : two === '~~' ? 'strikethrough' : ch === '*' || ch === '_' ? 'italic' : undefined;\n    if (kind !== undefined) {\n      const raw = kind === 'italic' ? ch : two;\n      const { canOpen, canClose } = delimiterFlanking(kind, raw, markdown[i - 1], markdown[i + raw.length]);\n      if (canOpen || canClose) {\n        flush();\n        tokens.push({ type: 'delim', kind, raw, canOpen, canClose });\n      } else {\n        // Fails flanking on both sides — literal text (e.g. \" * \" or intraword \"_\").\n        buffer += raw;\n      }\n      i += raw.length;\n      continue;\n    }\n\n    buffer += ch;\n    i += 1;\n  }\n  flush();\n  return tokens;\n}\n\n// ---------------------------------------------------------------------------\n// Delimiter matching (unmatched delimiters degrade to literal text)\n// ---------------------------------------------------------------------------\n\n/** Matches emphasis delimiter tokens by kind using a simple open/close stack (assumes well-nested markdown). */\nfunction matchDelimiters(tokens: Token[]): Map<number, number> {\n  const stack: { kind: EmphasisKind; tokenIndex: number }[] = [];\n  const openerToCloser = new Map<number, number>();\n\n  tokens.forEach((token, index) => {\n    if (token.type !== 'delim') return;\n    const top = stack[stack.length - 1];\n    if (token.canClose && top && top.kind === token.kind) {\n      stack.pop();\n      openerToCloser.set(top.tokenIndex, index);\n    } else if (token.canOpen) {\n      stack.push({ kind: token.kind, tokenIndex: index });\n    }\n    // Can neither close the current context nor open — stays unmatched (literal).\n  });\n\n  // Anything left on the stack never closed — leave unmatched (rendered literally by the caller).\n  return openerToCloser;\n}\n\nconst FORMAT_FOR_KIND: Record<EmphasisKind, sheets_v4.Schema$TextFormat> = {\n  bold: { bold: true },\n  italic: { italic: true },\n  strikethrough: { strikethrough: true },\n};\n\n/** Walks the token stream, resolving matched delimiter pairs into spans and unmatched ones into literal text. */\nfunction buildTextAndSpans(tokens: Token[]): { text: string; spans: MarkdownSpan[] } {\n  const openerToCloser = matchDelimiters(tokens);\n  const closerToOpener = new Map<number, number>();\n  for (const [opener, closer] of openerToCloser) closerToOpener.set(closer, opener);\n\n  let text = '';\n  const spans: MarkdownSpan[] = [];\n  const openerStart = new Map<number, number>(); // opener token index -> plain-text start offset\n\n  tokens.forEach((token, index) => {\n    if (token.type === 'text') {\n      text += token.value;\n      return;\n    }\n\n    if (token.type === 'link') {\n      const start = text.length;\n      text += token.label;\n      spans.push({ start, end: text.length, format: { link: { uri: token.uri } } });\n      return;\n    }\n\n    // Emphasis delimiter token.\n    if (openerToCloser.has(index)) {\n      // Matched opener — record where its span begins; the delimiter itself is consumed (not emitted).\n      openerStart.set(index, text.length);\n      return;\n    }\n    const openerIndex = closerToOpener.get(index);\n    if (openerIndex !== undefined) {\n      // Matched closer — emit the span from the recorded opener position to here.\n      const start = openerStart.get(openerIndex);\n      if (start === undefined) {\n        throw new Error('markdown-runs: internal error — emphasis opener position was not recorded');\n      }\n      spans.push({ start, end: text.length, format: FORMAT_FOR_KIND[token.kind] });\n      return;\n    }\n    // Unmatched delimiter — no syntactic partner, so it degrades to its literal characters.\n    text += token.raw;\n  });\n\n  return { text, spans };\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/** Parses inline markdown into plain text plus formatting spans (see module docs for the supported subset). */\nexport function parseInlineMarkdown(markdown: string): ParsedMarkdown {\n  const tokens = tokenize(markdown);\n  const { text, spans } = buildTextAndSpans(tokens);\n  const linkCount = spans.filter((span) => span.format.link !== undefined).length;\n  return { text, spans, linkCount };\n}\n\n/**\n * Builds `textFormatRuns` from parsed markdown spans.\n *\n * Three Sheets API rules drive this, and are easy to get wrong:\n *   1. A run's format persists to the end of the string unless a later run\n *      resets it with an empty `format: {}` — runs are NOT scoped to a range.\n *   2. A run must never be emitted at `startIndex === text.length`: a span\n *      that reaches the end of the string needs no \"turn it off\" run, because\n *      there's no text left for stray formatting to leak into.\n *   3. Runs must be listed in strictly increasing `startIndex` order, with no\n *      two runs sharing an index.\n *\n * The approach: collect every index where the set of \"active\" spans changes\n * (every span start, and every span end that isn't end-of-string), merge the\n * formats of all spans active at each such index into one run, then ensure\n * there is a run at index 0 — either a span already starts there, or an\n * explicit empty-format baseline is prepended so the cell doesn't inherit any\n * pre-existing rich text formatting.\n */\nexport function buildTextFormatRuns(parsed: ParsedMarkdown, styleLinks = true): sheets_v4.Schema$TextFormatRun[] {\n  const { text, spans } = parsed;\n  if (text.length === 0) return [];\n\n  const boundaries = new Set<number>();\n  for (const span of spans) {\n    boundaries.add(span.start);\n    if (span.end < text.length) boundaries.add(span.end);\n  }\n  const sortedBoundaries = [...boundaries].sort((a, b) => a - b);\n\n  const runs: sheets_v4.Schema$TextFormatRun[] = sortedBoundaries.map((startIndex) => {\n    const format: sheets_v4.Schema$TextFormat = {};\n    for (const span of spans) {\n      if (span.start <= startIndex && startIndex < span.end) {\n        Object.assign(format, span.format);\n      }\n    }\n    if (styleLinks && format.link) {\n      format.underline = true;\n      format.foregroundColorStyle = { rgbColor: LINK_BLUE };\n    }\n    return { startIndex, format };\n  });\n\n  if (runs.length === 0 || runs[0]?.startIndex !== 0) {\n    runs.unshift({ startIndex: 0, format: {} });\n  }\n\n  return runs;\n}\n"],"names":["LINK_BLUE","red","green","blue","MD_LINK","BARE_URL","ESCAPABLE","Set","trimTrailingPunctuation","url","replace","isWhitespaceOrEdge","ch","undefined","test","isWordChar","delimiterFlanking","_kind","raw","prev","next","underscore","startsWith","canOpen","canClose","tokenize","markdown","tokens","buffer","flush","push","type","value","i","length","has","linkMatch","exec","slice","rawLabel","trim","uri","label","bareMatch","two","kind","matchDelimiters","stack","openerToCloser","Map","forEach","token","index","top","pop","set","tokenIndex","FORMAT_FOR_KIND","bold","italic","strikethrough","buildTextAndSpans","closerToOpener","opener","closer","text","spans","openerStart","start","end","format","link","openerIndex","get","Error","parseInlineMarkdown","linkCount","filter","span","buildTextFormatRuns","parsed","styleLinks","runs","boundaries","add","sortedBoundaries","sort","a","b","map","startIndex","Object","assign","underline","foregroundColorStyle","rgbColor","unshift"],"mappings":"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"}

package/dist/esm/spreadsheet/range-operations.d.ts

@@ -122,7 +122,7 @@ export declare function buildValuesBatchUpdateRequest(requests: Array<{
     valueInputOption: "RAW" | "USER_ENTERED";
     data: {
         range: string;
-        values: (string | number | boolean)[][];
+        values: (string | number | boolean | null | undefined)[][];
         majorDimension: "ROWS" | "COLUMNS";
     }[];
     includeValuesInResponse: boolean;

package/dist/esm/spreadsheet/range-operations.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/Projects/mcp-z/mcp-sheets/src/spreadsheet/range-operations.ts"],"sourcesContent":["/**\n * Range Operations Utilities for Google Sheets\n *\n * This module provides comprehensive utilities for working with A1 notation,\n * range parsing, batch operations, and range validation in Google Sheets.\n *\n * Key features:\n * - A1 notation validation and parsing\n * - Range manipulation and calculation utilities\n * - Batch operation builders for Google Sheets API\n * - Cell count and dimension calculations\n * - Range conflict detection for batch operations\n * - Google Sheets limits validation and enforcement\n */\n\nimport { a1Col } from './column-utilities.ts';\n\n// Google Sheets constants and limits\nexport const GOOGLE_SHEETS_LIMITS = {\n  MAX_ROWS: 10_000_000,\n  MAX_COLUMNS: 18_278, // ZZZ in base-26\n  MAX_CELLS: 10_000_000, // Approximate limit for total cells\n  MAX_BATCH_REQUESTS: 1000,\n  MAX_DIMENSION_BATCH_REQUESTS: 100,\n} as const;\n\n/**\n * Represents a parsed cell reference (e.g., A1, B5)\n */\nexport interface CellReference {\n  column: string;\n  columnIndex: number; // 1-based\n  row: number; // 1-based\n}\n\n/**\n * Represents a parsed range (e.g., A1:B5, A:B, 1:2)\n */\nexport interface RangeReference {\n  type: 'cell' | 'row' | 'column' | 'range';\n  startCell?: CellReference;\n  endCell?: CellReference;\n  startRow?: number;\n  endRow?: number;\n  startColumn?: string;\n  endColumn?: string;\n  startColumnIndex?: number;\n  endColumnIndex?: number;\n}\n\n/**\n * Represents dimensions of a range\n */\nexport interface RangeDimensions {\n  rows: number;\n  columns: number;\n  cells: number;\n}\n\n/**\n * Represents a range conflict between two ranges\n */\nexport interface RangeConflict {\n  range1: string;\n  range2: string;\n  conflictType: 'overlap' | 'contains' | 'contained' | 'adjacent';\n  description: string;\n}\n\n/**\n * A1 Notation Validation Utilities\n */\n\n/**\n * Validates if a string is a valid A1 notation\n */\nexport function isValidA1Notation(notation: string): boolean {\n  if (!notation || typeof notation !== 'string') {\n    return false;\n  }\n\n  // Use the same regex pattern as in the schema\n  const a1Pattern = /^(?:[A-Z]{1,3}(?:[1-9]\\d{0,6}|10000000)(?::[A-Z]{1,3}(?:[1-9]\\d{0,6}|10000000))?|[A-Z]{1,3}:[A-Z]{1,3}|(?:[1-9]\\d{0,6}|10000000):(?:[1-9]\\d{0,6}|10000000))$/;\n\n  if (!a1Pattern.test(notation)) {\n    return false;\n  }\n\n  // Additional validation for Google Sheets limits\n  const parts = notation.split(':');\n\n  for (const part of parts) {\n    // Check cell reference\n    const cellMatch = part.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n    if (cellMatch && cellMatch[1] && cellMatch[2]) {\n      const [, colStr, rowStr] = cellMatch;\n\n      // Validate column\n      const colNum = columnStringToIndex(colStr);\n      if (colNum > GOOGLE_SHEETS_LIMITS.MAX_COLUMNS) {\n        return false;\n      }\n\n      // Validate row\n      const rowNum = parseInt(rowStr, 10);\n      if (rowNum > GOOGLE_SHEETS_LIMITS.MAX_ROWS) {\n        return false;\n      }\n    }\n\n    // Check column reference\n    const colMatch = part.match(/^([A-Z]{1,3})$/);\n    if (colMatch && colMatch[1]) {\n      const colNum = columnStringToIndex(colMatch[1]);\n      if (colNum > GOOGLE_SHEETS_LIMITS.MAX_COLUMNS) {\n        return false;\n      }\n    }\n\n    // Check row reference\n    const rowMatch = part.match(/^([1-9]\\d{0,6}|10000000)$/);\n    if (rowMatch && rowMatch[1]) {\n      const rowNum = parseInt(rowMatch[1], 10);\n      if (rowNum > GOOGLE_SHEETS_LIMITS.MAX_ROWS) {\n        return false;\n      }\n    }\n  }\n\n  return true;\n}\n\n/**\n * Validates A1 notation and throws detailed error if invalid\n */\nexport function validateA1Notation(notation: string): void {\n  if (!isValidA1Notation(notation)) {\n    throw new Error(`Invalid A1 notation: \"${notation}\". Valid formats: A1, A1:B2, A:B, 1:2`);\n  }\n}\n\n/**\n * Range Parsing and Manipulation Functions\n */\n\n/**\n * Converts column string (A, B, AA, etc.) to 1-based index\n */\nexport function columnStringToIndex(colStr: string): number {\n  let colNum = 0;\n  for (let i = 0; i < colStr.length; i++) {\n    colNum = colNum * 26 + (colStr.charCodeAt(i) - 64);\n  }\n  return colNum;\n}\n\n/**\n * Converts 1-based column index to column string (A, B, AA, etc.)\n */\nexport function columnIndexToString(colIndex: number): string {\n  return a1Col(colIndex);\n}\n\n/**\n * Parses a cell reference (e.g., \"A1\", \"Z999\") into its components\n */\nexport function parseCellReference(cellRef: string): CellReference {\n  const match = cellRef.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n  if (!match || !match[1] || !match[2]) {\n    throw new Error(`Invalid cell reference: ${cellRef}`);\n  }\n\n  const [, column, rowStr] = match;\n  const row = parseInt(rowStr, 10);\n  const columnIndex = columnStringToIndex(column);\n\n  return {\n    column,\n    columnIndex,\n    row,\n  };\n}\n\n/**\n * Parses A1 notation into a structured range reference\n */\nexport function parseA1Notation(notation: string): RangeReference {\n  validateA1Notation(notation);\n\n  const parts = notation.split(':');\n\n  if (parts.length === 1) {\n    const part = parts[0];\n    if (!part) {\n      throw new Error('Invalid A1 notation: empty part after split');\n    }\n\n    // Single cell reference (e.g., A1)\n    const cellMatch = part.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n    if (cellMatch && cellMatch[1] && cellMatch[2]) {\n      const startCell = parseCellReference(part);\n      return {\n        type: 'cell',\n        startCell,\n        endCell: startCell,\n      };\n    }\n\n    // Single column reference (e.g., A)\n    const colMatch = part.match(/^([A-Z]{1,3})$/);\n    if (colMatch && colMatch[1]) {\n      const column = colMatch[1];\n      const columnIndex = columnStringToIndex(column);\n      return {\n        type: 'column',\n        startColumn: column,\n        endColumn: column,\n        startColumnIndex: columnIndex,\n        endColumnIndex: columnIndex,\n      };\n    }\n\n    // Single row reference (e.g., 1)\n    const rowMatch = part.match(/^([1-9]\\d{0,6}|10000000)$/);\n    if (rowMatch && rowMatch[1]) {\n      const row = parseInt(rowMatch[1], 10);\n      return {\n        type: 'row',\n        startRow: row,\n        endRow: row,\n      };\n    }\n  }\n\n  if (parts.length === 2 && parts[0] && parts[1]) {\n    const [start, end] = parts;\n\n    // Cell range (e.g., A1:B5)\n    const startCellMatch = start.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n    const endCellMatch = end.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n\n    if (startCellMatch && endCellMatch && startCellMatch[1] && startCellMatch[2] && endCellMatch[1] && endCellMatch[2]) {\n      const startCell = parseCellReference(start);\n      const endCell = parseCellReference(end);\n      return {\n        type: 'range',\n        startCell,\n        endCell,\n      };\n    }\n\n    // Column range (e.g., A:B)\n    const startColMatch = start.match(/^([A-Z]{1,3})$/);\n    const endColMatch = end.match(/^([A-Z]{1,3})$/);\n\n    if (startColMatch && endColMatch && startColMatch[1] && endColMatch[1]) {\n      const startColumn = startColMatch[1];\n      const endColumn = endColMatch[1];\n      const startColumnIndex = columnStringToIndex(startColumn);\n      const endColumnIndex = columnStringToIndex(endColumn);\n      return {\n        type: 'column',\n        startColumn,\n        endColumn,\n        startColumnIndex,\n        endColumnIndex,\n      };\n    }\n\n    // Row range (e.g., 1:5)\n    const startRowMatch = start.match(/^([1-9]\\d{0,6}|10000000)$/);\n    const endRowMatch = end.match(/^([1-9]\\d{0,6}|10000000)$/);\n\n    if (startRowMatch && endRowMatch && startRowMatch[1] && endRowMatch[1]) {\n      const startRow = parseInt(startRowMatch[1], 10);\n      const endRow = parseInt(endRowMatch[1], 10);\n      return {\n        type: 'row',\n        startRow,\n        endRow,\n      };\n    }\n  }\n\n  throw new Error(`Unable to parse A1 notation: ${notation}`);\n}\n\n/**\n * Converts a range reference back to A1 notation\n */\nexport function rangeToA1Notation(range: RangeReference): string {\n  switch (range.type) {\n    case 'cell':\n      if (!range.startCell) throw new Error('Invalid cell range: missing startCell');\n      return `${range.startCell.column}${range.startCell.row}`;\n\n    case 'range':\n      if (!range.startCell || !range.endCell) throw new Error('Invalid range: missing start or end cell');\n      return `${range.startCell.column}${range.startCell.row}:${range.endCell.column}${range.endCell.row}`;\n\n    case 'column':\n      if (!range.startColumn || !range.endColumn) throw new Error('Invalid column range: missing start or end column');\n      if (range.startColumn === range.endColumn) {\n        return range.startColumn;\n      }\n      return `${range.startColumn}:${range.endColumn}`;\n\n    case 'row':\n      if (range.startRow === undefined || range.endRow === undefined) throw new Error('Invalid row range: missing start or end row');\n      if (range.startRow === range.endRow) {\n        return range.startRow.toString();\n      }\n      return `${range.startRow}:${range.endRow}`;\n\n    default:\n      throw new Error(`Unknown range type: ${(range as { type: unknown }).type}`);\n  }\n}\n\n/**\n * Cell Count and Dimension Calculation Utilities\n */\n\n/**\n * Calculates the dimensions of a range\n */\nexport function calculateRangeDimensions(notation: string): RangeDimensions {\n  const range = parseA1Notation(notation);\n\n  switch (range.type) {\n    case 'cell':\n      return { rows: 1, columns: 1, cells: 1 };\n\n    case 'range': {\n      if (!range.startCell || !range.endCell) throw new Error('Invalid range: missing cells');\n      const rows = range.endCell.row - range.startCell.row + 1;\n      const columns = range.endCell.columnIndex - range.startCell.columnIndex + 1;\n      return { rows, columns, cells: rows * columns };\n    }\n\n    case 'column': {\n      if (range.startColumnIndex === undefined || range.endColumnIndex === undefined) {\n        throw new Error('Invalid column range: missing column indices');\n      }\n      const columnCount = range.endColumnIndex - range.startColumnIndex + 1;\n      return {\n        rows: GOOGLE_SHEETS_LIMITS.MAX_ROWS,\n        columns: columnCount,\n        cells: GOOGLE_SHEETS_LIMITS.MAX_ROWS * columnCount,\n      };\n    }\n\n    case 'row': {\n      if (range.startRow === undefined || range.endRow === undefined) {\n        throw new Error('Invalid row range: missing row numbers');\n      }\n      const rowCount = range.endRow - range.startRow + 1;\n      return {\n        rows: rowCount,\n        columns: GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n        cells: rowCount * GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n      };\n    }\n\n    default:\n      throw new Error(`Unknown range type: ${(range as { type: string }).type}`);\n  }\n}\n\n/**\n * Calculates total cells affected by multiple ranges\n */\nexport function calculateTotalCells(ranges: string[]): number {\n  return ranges.reduce((total, range) => {\n    const dimensions = calculateRangeDimensions(range);\n    return total + dimensions.cells;\n  }, 0);\n}\n\n/**\n * Batch Operation Builders for Google API\n */\n\n/**\n * Builds a values batch update request for Google Sheets API\n */\nexport function buildValuesBatchUpdateRequest(\n  requests: Array<{\n    range: string;\n    values: (string | number | boolean | null | undefined)[][];\n    majorDimension?: 'ROWS' | 'COLUMNS';\n  }>,\n  sheetTitle: string,\n  options: {\n    valueInputOption?: 'RAW' | 'USER_ENTERED';\n    includeValuesInResponse?: boolean;\n    responseDateTimeRenderOption?: 'FORMATTED_STRING' | 'SERIAL_NUMBER';\n    responseValueRenderOption?: 'FORMATTED_VALUE' | 'UNFORMATTED_VALUE' | 'FORMULA';\n  } = {}\n) {\n  // Validate all ranges first\n  requests.forEach((req, index) => {\n    try {\n      validateA1Notation(req.range);\n    } catch (error) {\n      throw new Error(`Invalid range in request ${index}: ${error}`);\n    }\n  });\n\n  // Calculate total cells for validation\n  const totalCells = calculateTotalCells(requests.map((r) => r.range));\n  if (totalCells > GOOGLE_SHEETS_LIMITS.MAX_CELLS) {\n    throw new Error(`Batch update exceeds maximum cells limit: ${totalCells} > ${GOOGLE_SHEETS_LIMITS.MAX_CELLS}`);\n  }\n\n  // Build the request\n  const data = requests.map((req) => ({\n    range: `${sheetTitle}!${req.range}`,\n    values: req.values,\n    majorDimension: req.majorDimension || 'ROWS',\n  }));\n\n  return {\n    valueInputOption: options.valueInputOption || 'USER_ENTERED',\n    data,\n    includeValuesInResponse: options.includeValuesInResponse || false,\n    responseDateTimeRenderOption: options.responseDateTimeRenderOption || 'FORMATTED_STRING',\n    responseValueRenderOption: options.responseValueRenderOption || 'FORMATTED_VALUE',\n  };\n}\n\n/**\n * Range Conflict Detection\n */\n\n/**\n * Checks if two ranges overlap\n */\nexport function rangesOverlap(range1: string, range2: string): boolean {\n  try {\n    const parsed1 = parseA1Notation(range1);\n    const parsed2 = parseA1Notation(range2);\n\n    // Different types might still overlap, so we need to normalize to cell ranges\n    const normalized1 = normalizeRangeToBounds(parsed1);\n    const normalized2 = normalizeRangeToBounds(parsed2);\n\n    // Check for overlap\n    return !(normalized1.endRow < normalized2.startRow || normalized2.endRow < normalized1.startRow || normalized1.endCol < normalized2.startCol || normalized2.endCol < normalized1.startCol);\n  } catch {\n    // If we can't parse the ranges, assume no overlap\n    return false;\n  }\n}\n\n/**\n * Normalizes a range to bounds for overlap checking\n */\nfunction normalizeRangeToBounds(range: RangeReference): {\n  startRow: number;\n  endRow: number;\n  startCol: number;\n  endCol: number;\n} {\n  switch (range.type) {\n    case 'cell':\n      if (!range.startCell) throw new Error('Invalid cell range');\n      return {\n        startRow: range.startCell.row,\n        endRow: range.startCell.row,\n        startCol: range.startCell.columnIndex,\n        endCol: range.startCell.columnIndex,\n      };\n\n    case 'range':\n      if (!range.startCell || !range.endCell) throw new Error('Invalid range');\n      return {\n        startRow: range.startCell.row,\n        endRow: range.endCell.row,\n        startCol: range.startCell.columnIndex,\n        endCol: range.endCell.columnIndex,\n      };\n\n    case 'column':\n      if (range.startColumnIndex === undefined || range.endColumnIndex === undefined) {\n        throw new Error('Invalid column range');\n      }\n      return {\n        startRow: 1,\n        endRow: GOOGLE_SHEETS_LIMITS.MAX_ROWS,\n        startCol: range.startColumnIndex,\n        endCol: range.endColumnIndex,\n      };\n\n    case 'row':\n      if (range.startRow === undefined || range.endRow === undefined) {\n        throw new Error('Invalid row range');\n      }\n      return {\n        startRow: range.startRow,\n        endRow: range.endRow,\n        startCol: 1,\n        endCol: GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n      };\n\n    default:\n      throw new Error(`Unknown range type: ${(range as { type: unknown }).type}`);\n  }\n}\n\n/**\n * Detects conflicts between multiple ranges\n */\nexport function detectRangeConflicts(ranges: string[]): RangeConflict[] {\n  const conflicts: RangeConflict[] = [];\n\n  for (let i = 0; i < ranges.length; i++) {\n    for (let j = i + 1; j < ranges.length; j++) {\n      const range1 = ranges[i];\n      const range2 = ranges[j];\n\n      if (!range1 || !range2) continue;\n\n      if (rangesOverlap(range1, range2)) {\n        conflicts.push({\n          range1,\n          range2,\n          conflictType: 'overlap',\n          description: `Ranges ${range1} and ${range2} overlap`,\n        });\n      }\n    }\n  }\n\n  return conflicts;\n}\n\n/**\n * Validates that a batch of ranges doesn't exceed Google Sheets limits\n */\nexport function validateBatchRanges(ranges: string[]): {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n  totalCells: number;\n} {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  let totalCells = 0;\n\n  // Validate each range\n  ranges.forEach((range, index) => {\n    try {\n      validateA1Notation(range);\n      const dimensions = calculateRangeDimensions(range);\n      totalCells += dimensions.cells;\n\n      // Check for very large ranges that might cause performance issues\n      if (dimensions.cells > 1_000_000) {\n        warnings.push(`Range ${index + 1} (${range}) affects ${dimensions.cells.toLocaleString()} cells, which may impact performance`);\n      }\n    } catch (error) {\n      errors.push(`Range ${index + 1} (${range}): ${error}`);\n    }\n  });\n\n  // Check batch size limits\n  if (ranges.length > GOOGLE_SHEETS_LIMITS.MAX_BATCH_REQUESTS) {\n    errors.push(`Too many ranges: ${ranges.length} > ${GOOGLE_SHEETS_LIMITS.MAX_BATCH_REQUESTS}`);\n  }\n\n  // Check total cells limit\n  if (totalCells > GOOGLE_SHEETS_LIMITS.MAX_CELLS) {\n    errors.push(`Total cells exceed limit: ${totalCells.toLocaleString()} > ${GOOGLE_SHEETS_LIMITS.MAX_CELLS.toLocaleString()}`);\n  }\n\n  // Check for conflicts\n  const conflicts = detectRangeConflicts(ranges);\n  conflicts.forEach((conflict) => {\n    warnings.push(conflict.description);\n  });\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n    totalCells,\n  };\n}\n\n/**\n * Utility Functions for Common Range Operations\n */\n\n/**\n * Expands a range by a specified number of rows and columns\n */\nexport function expandRange(notation: string, expandRows: number, expandCols: number): string {\n  const range = parseA1Notation(notation);\n\n  if (range.type === 'cell' && range.startCell) {\n    const newEndRow = Math.min(range.startCell.row + expandRows, GOOGLE_SHEETS_LIMITS.MAX_ROWS);\n    const newEndCol = Math.min(range.startCell.columnIndex + expandCols, GOOGLE_SHEETS_LIMITS.MAX_COLUMNS);\n    const newEndColStr = columnIndexToString(newEndCol);\n\n    if (expandRows === 0 && expandCols === 0) {\n      return notation;\n    }\n\n    return `${range.startCell.column}${range.startCell.row}:${newEndColStr}${newEndRow}`;\n  }\n\n  if (range.type === 'range' && range.startCell && range.endCell) {\n    const newEndRow = Math.min(range.endCell.row + expandRows, GOOGLE_SHEETS_LIMITS.MAX_ROWS);\n    const newEndCol = Math.min(range.endCell.columnIndex + expandCols, GOOGLE_SHEETS_LIMITS.MAX_COLUMNS);\n    const newEndColStr = columnIndexToString(newEndCol);\n\n    return `${range.startCell.column}${range.startCell.row}:${newEndColStr}${newEndRow}`;\n  }\n\n  // For row and column ranges, expansion doesn't make sense in the same way\n  return notation;\n}\n\n/**\n * Gets the intersection of two ranges\n */\nexport function getRangeIntersection(range1: string, range2: string): string | null {\n  try {\n    const parsed1 = parseA1Notation(range1);\n    const parsed2 = parseA1Notation(range2);\n\n    const bounds1 = normalizeRangeToBounds(parsed1);\n    const bounds2 = normalizeRangeToBounds(parsed2);\n\n    // Check if they overlap\n    if (!rangesOverlap(range1, range2)) {\n      return null;\n    }\n\n    // Calculate intersection bounds\n    const startRow = Math.max(bounds1.startRow, bounds2.startRow);\n    const endRow = Math.min(bounds1.endRow, bounds2.endRow);\n    const startCol = Math.max(bounds1.startCol, bounds2.startCol);\n    const endCol = Math.min(bounds1.endCol, bounds2.endCol);\n\n    const startColStr = columnIndexToString(startCol);\n    const endColStr = columnIndexToString(endCol);\n\n    if (startRow === endRow && startCol === endCol) {\n      return `${startColStr}${startRow}`;\n    }\n\n    return `${startColStr}${startRow}:${endColStr}${endRow}`;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Splits a large range into smaller chunks for batch processing\n */\nexport function splitRangeIntoChunks(notation: string, maxCellsPerChunk = 100_000): string[] {\n  const range = parseA1Notation(notation);\n  const dimensions = calculateRangeDimensions(notation);\n\n  if (dimensions.cells <= maxCellsPerChunk) {\n    return [notation];\n  }\n\n  const chunks: string[] = [];\n\n  if (range.type === 'range' && range.startCell && range.endCell) {\n    const totalRows = range.endCell.row - range.startCell.row + 1;\n    const totalCols = range.endCell.columnIndex - range.startCell.columnIndex + 1;\n\n    // Calculate chunk size based on max cells\n    const cellsPerRow = totalCols;\n    const maxRowsPerChunk = Math.floor(maxCellsPerChunk / cellsPerRow);\n\n    if (maxRowsPerChunk >= 1) {\n      // Split by rows\n      for (let currentRow = range.startCell.row; currentRow <= range.endCell.row; currentRow += maxRowsPerChunk) {\n        const chunkEndRow = Math.min(currentRow + maxRowsPerChunk - 1, range.endCell.row);\n        const chunkRange = `${range.startCell.column}${currentRow}:${range.endCell.column}${chunkEndRow}`;\n        chunks.push(chunkRange);\n      }\n    } else {\n      // If even one row is too big, split by columns\n      const maxColsPerChunk = Math.floor(maxCellsPerChunk / totalRows);\n\n      for (let currentCol = range.startCell.columnIndex; currentCol <= range.endCell.columnIndex; currentCol += maxColsPerChunk) {\n        const chunkEndCol = Math.min(currentCol + maxColsPerChunk - 1, range.endCell.columnIndex);\n        const startColStr = columnIndexToString(currentCol);\n        const endColStr = columnIndexToString(chunkEndCol);\n        const chunkRange = `${startColStr}${range.startCell.row}:${endColStr}${range.endCell.row}`;\n        chunks.push(chunkRange);\n      }\n    }\n  } else {\n    // For other range types, just return the original range\n    // (column and row ranges are already at their limits)\n    chunks.push(notation);\n  }\n\n  return chunks;\n}\n\n/**\n * Converts a RangeReference to Google Sheets API GridRange format\n *\n * This handles the different range types correctly:\n * - 'cell' and 'range' types: Extract indices from startCell/endCell\n * - 'row' types: Use startRow/endRow, omit column indices for full row\n * - 'column' types: Use startColumnIndex/endColumnIndex, omit row indices for full column\n *\n * Important: Google Sheets API uses 0-based indices, while A1 notation uses 1-based indices.\n * This function handles the conversion properly for each range type.\n */\nexport function rangeReferenceToGridRange(\n  rangeRef: RangeReference,\n  sheetId: number\n): {\n  sheetId: number;\n  startRowIndex?: number;\n  endRowIndex?: number;\n  startColumnIndex?: number;\n  endColumnIndex?: number;\n} {\n  if (rangeRef.type === 'cell' || rangeRef.type === 'range') {\n    // For cell and range types, extract from startCell/endCell\n    if (!rangeRef.startCell || !rangeRef.endCell) {\n      throw new Error(`Invalid ${rangeRef.type} range: missing start or end cell`);\n    }\n\n    return {\n      sheetId,\n      // Convert 1-based row to 0-based startRowIndex\n      startRowIndex: rangeRef.startCell.row - 1,\n      // endRowIndex is exclusive (so row 5 becomes endRowIndex 5)\n      endRowIndex: rangeRef.endCell.row,\n      // Convert 1-based column index to 0-based startColumnIndex\n      startColumnIndex: rangeRef.startCell.columnIndex - 1,\n      // endColumnIndex is exclusive\n      endColumnIndex: rangeRef.endCell.columnIndex,\n    };\n  }\n  if (rangeRef.type === 'row') {\n    // For row types, use startRow/endRow and omit column indices for full row width\n    if (rangeRef.startRow === undefined || rangeRef.endRow === undefined) {\n      throw new Error('Invalid row range: missing start or end row');\n    }\n\n    return {\n      sheetId,\n      // Convert 1-based row to 0-based startRowIndex\n      startRowIndex: rangeRef.startRow - 1,\n      // endRowIndex is exclusive\n      endRowIndex: rangeRef.endRow,\n      // Omit startColumnIndex and endColumnIndex to apply to all columns\n    };\n  }\n  if (rangeRef.type === 'column') {\n    // For column types, use startColumnIndex/endColumnIndex and omit row indices for full column height\n    if (rangeRef.startColumnIndex === undefined || rangeRef.endColumnIndex === undefined) {\n      throw new Error('Invalid column range: missing start or end column index');\n    }\n\n    return {\n      sheetId,\n      // Omit startRowIndex and endRowIndex to apply to all rows\n      // Convert 1-based column index to 0-based startColumnIndex\n      startColumnIndex: rangeRef.startColumnIndex - 1,\n      // endColumnIndex is exclusive\n      endColumnIndex: rangeRef.endColumnIndex,\n    };\n  }\n\n  throw new Error(`Unknown range type: ${(rangeRef as { type: unknown }).type}`);\n}\n"],"names":["a1Col","GOOGLE_SHEETS_LIMITS","MAX_ROWS","MAX_COLUMNS","MAX_CELLS","MAX_BATCH_REQUESTS","MAX_DIMENSION_BATCH_REQUESTS","isValidA1Notation","notation","a1Pattern","test","parts","split","part","cellMatch","match","colStr","rowStr","colNum","columnStringToIndex","rowNum","parseInt","colMatch","rowMatch","validateA1Notation","Error","i","length","charCodeAt","columnIndexToString","colIndex","parseCellReference","cellRef","column","row","columnIndex","parseA1Notation","startCell","type","endCell","startColumn","endColumn","startColumnIndex","endColumnIndex","startRow","endRow","start","end","startCellMatch","endCellMatch","startColMatch","endColMatch","startRowMatch","endRowMatch","rangeToA1Notation","range","undefined","toString","calculateRangeDimensions","rows","columns","cells","columnCount","rowCount","calculateTotalCells","ranges","reduce","total","dimensions","buildValuesBatchUpdateRequest","requests","sheetTitle","options","forEach","req","index","error","totalCells","map","r","data","values","majorDimension","valueInputOption","includeValuesInResponse","responseDateTimeRenderOption","responseValueRenderOption","rangesOverlap","range1","range2","parsed1","parsed2","normalized1","normalizeRangeToBounds","normalized2","endCol","startCol","detectRangeConflicts","conflicts","j","push","conflictType","description","validateBatchRanges","errors","warnings","toLocaleString","conflict","valid","expandRange","expandRows","expandCols","newEndRow","Math","min","newEndCol","newEndColStr","getRangeIntersection","bounds1","bounds2","max","startColStr","endColStr","splitRangeIntoChunks","maxCellsPerChunk","chunks","totalRows","totalCols","cellsPerRow","maxRowsPerChunk","floor","currentRow","chunkEndRow","chunkRange","maxColsPerChunk","currentCol","chunkEndCol","rangeReferenceToGridRange","rangeRef","sheetId","startRowIndex","endRowIndex"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/ai/mcp-z/mcp-sheets/src/spreadsheet/range-operations.ts"],"sourcesContent":["/**\n * Range Operations Utilities for Google Sheets\n *\n * This module provides comprehensive utilities for working with A1 notation,\n * range parsing, batch operations, and range validation in Google Sheets.\n *\n * Key features:\n * - A1 notation validation and parsing\n * - Range manipulation and calculation utilities\n * - Batch operation builders for Google Sheets API\n * - Cell count and dimension calculations\n * - Range conflict detection for batch operations\n * - Google Sheets limits validation and enforcement\n */\n\nimport { a1Col } from './column-utilities.ts';\n\n// Google Sheets constants and limits\nexport const GOOGLE_SHEETS_LIMITS = {\n  MAX_ROWS: 10_000_000,\n  MAX_COLUMNS: 18_278, // ZZZ in base-26\n  MAX_CELLS: 10_000_000, // Approximate limit for total cells\n  MAX_BATCH_REQUESTS: 1000,\n  MAX_DIMENSION_BATCH_REQUESTS: 100,\n} as const;\n\n/**\n * Represents a parsed cell reference (e.g., A1, B5)\n */\nexport interface CellReference {\n  column: string;\n  columnIndex: number; // 1-based\n  row: number; // 1-based\n}\n\n/**\n * Represents a parsed range (e.g., A1:B5, A:B, 1:2)\n */\nexport interface RangeReference {\n  type: 'cell' | 'row' | 'column' | 'range';\n  startCell?: CellReference;\n  endCell?: CellReference;\n  startRow?: number;\n  endRow?: number;\n  startColumn?: string;\n  endColumn?: string;\n  startColumnIndex?: number;\n  endColumnIndex?: number;\n}\n\n/**\n * Represents dimensions of a range\n */\nexport interface RangeDimensions {\n  rows: number;\n  columns: number;\n  cells: number;\n}\n\n/**\n * Represents a range conflict between two ranges\n */\nexport interface RangeConflict {\n  range1: string;\n  range2: string;\n  conflictType: 'overlap' | 'contains' | 'contained' | 'adjacent';\n  description: string;\n}\n\n/**\n * A1 Notation Validation Utilities\n */\n\n/**\n * Validates if a string is a valid A1 notation\n */\nexport function isValidA1Notation(notation: string): boolean {\n  if (!notation || typeof notation !== 'string') {\n    return false;\n  }\n\n  // Use the same regex pattern as in the schema\n  const a1Pattern = /^(?:[A-Z]{1,3}(?:[1-9]\\d{0,6}|10000000)(?::[A-Z]{1,3}(?:[1-9]\\d{0,6}|10000000))?|[A-Z]{1,3}:[A-Z]{1,3}|(?:[1-9]\\d{0,6}|10000000):(?:[1-9]\\d{0,6}|10000000))$/;\n\n  if (!a1Pattern.test(notation)) {\n    return false;\n  }\n\n  // Additional validation for Google Sheets limits\n  const parts = notation.split(':');\n\n  for (const part of parts) {\n    // Check cell reference\n    const cellMatch = part.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n    if (cellMatch && cellMatch[1] && cellMatch[2]) {\n      const [, colStr, rowStr] = cellMatch;\n\n      // Validate column\n      const colNum = columnStringToIndex(colStr);\n      if (colNum > GOOGLE_SHEETS_LIMITS.MAX_COLUMNS) {\n        return false;\n      }\n\n      // Validate row\n      const rowNum = parseInt(rowStr, 10);\n      if (rowNum > GOOGLE_SHEETS_LIMITS.MAX_ROWS) {\n        return false;\n      }\n    }\n\n    // Check column reference\n    const colMatch = part.match(/^([A-Z]{1,3})$/);\n    if (colMatch && colMatch[1]) {\n      const colNum = columnStringToIndex(colMatch[1]);\n      if (colNum > GOOGLE_SHEETS_LIMITS.MAX_COLUMNS) {\n        return false;\n      }\n    }\n\n    // Check row reference\n    const rowMatch = part.match(/^([1-9]\\d{0,6}|10000000)$/);\n    if (rowMatch && rowMatch[1]) {\n      const rowNum = parseInt(rowMatch[1], 10);\n      if (rowNum > GOOGLE_SHEETS_LIMITS.MAX_ROWS) {\n        return false;\n      }\n    }\n  }\n\n  return true;\n}\n\n/**\n * Validates A1 notation and throws detailed error if invalid\n */\nexport function validateA1Notation(notation: string): void {\n  if (!isValidA1Notation(notation)) {\n    throw new Error(`Invalid A1 notation: \"${notation}\". Valid formats: A1, A1:B2, A:B, 1:2`);\n  }\n}\n\n/**\n * Range Parsing and Manipulation Functions\n */\n\n/**\n * Converts column string (A, B, AA, etc.) to 1-based index\n */\nexport function columnStringToIndex(colStr: string): number {\n  let colNum = 0;\n  for (let i = 0; i < colStr.length; i++) {\n    colNum = colNum * 26 + (colStr.charCodeAt(i) - 64);\n  }\n  return colNum;\n}\n\n/**\n * Converts 1-based column index to column string (A, B, AA, etc.)\n */\nexport function columnIndexToString(colIndex: number): string {\n  return a1Col(colIndex);\n}\n\n/**\n * Parses a cell reference (e.g., \"A1\", \"Z999\") into its components\n */\nexport function parseCellReference(cellRef: string): CellReference {\n  const match = cellRef.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n  if (!match || !match[1] || !match[2]) {\n    throw new Error(`Invalid cell reference: ${cellRef}`);\n  }\n\n  const [, column, rowStr] = match;\n  const row = parseInt(rowStr, 10);\n  const columnIndex = columnStringToIndex(column);\n\n  return {\n    column,\n    columnIndex,\n    row,\n  };\n}\n\n/**\n * Parses A1 notation into a structured range reference\n */\nexport function parseA1Notation(notation: string): RangeReference {\n  validateA1Notation(notation);\n\n  const parts = notation.split(':');\n\n  if (parts.length === 1) {\n    const part = parts[0];\n    if (!part) {\n      throw new Error('Invalid A1 notation: empty part after split');\n    }\n\n    // Single cell reference (e.g., A1)\n    const cellMatch = part.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n    if (cellMatch && cellMatch[1] && cellMatch[2]) {\n      const startCell = parseCellReference(part);\n      return {\n        type: 'cell',\n        startCell,\n        endCell: startCell,\n      };\n    }\n\n    // Single column reference (e.g., A)\n    const colMatch = part.match(/^([A-Z]{1,3})$/);\n    if (colMatch && colMatch[1]) {\n      const column = colMatch[1];\n      const columnIndex = columnStringToIndex(column);\n      return {\n        type: 'column',\n        startColumn: column,\n        endColumn: column,\n        startColumnIndex: columnIndex,\n        endColumnIndex: columnIndex,\n      };\n    }\n\n    // Single row reference (e.g., 1)\n    const rowMatch = part.match(/^([1-9]\\d{0,6}|10000000)$/);\n    if (rowMatch && rowMatch[1]) {\n      const row = parseInt(rowMatch[1], 10);\n      return {\n        type: 'row',\n        startRow: row,\n        endRow: row,\n      };\n    }\n  }\n\n  if (parts.length === 2 && parts[0] && parts[1]) {\n    const [start, end] = parts;\n\n    // Cell range (e.g., A1:B5)\n    const startCellMatch = start.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n    const endCellMatch = end.match(/^([A-Z]{1,3})([1-9]\\d{0,6}|10000000)$/);\n\n    if (startCellMatch && endCellMatch && startCellMatch[1] && startCellMatch[2] && endCellMatch[1] && endCellMatch[2]) {\n      const startCell = parseCellReference(start);\n      const endCell = parseCellReference(end);\n      return {\n        type: 'range',\n        startCell,\n        endCell,\n      };\n    }\n\n    // Column range (e.g., A:B)\n    const startColMatch = start.match(/^([A-Z]{1,3})$/);\n    const endColMatch = end.match(/^([A-Z]{1,3})$/);\n\n    if (startColMatch && endColMatch && startColMatch[1] && endColMatch[1]) {\n      const startColumn = startColMatch[1];\n      const endColumn = endColMatch[1];\n      const startColumnIndex = columnStringToIndex(startColumn);\n      const endColumnIndex = columnStringToIndex(endColumn);\n      return {\n        type: 'column',\n        startColumn,\n        endColumn,\n        startColumnIndex,\n        endColumnIndex,\n      };\n    }\n\n    // Row range (e.g., 1:5)\n    const startRowMatch = start.match(/^([1-9]\\d{0,6}|10000000)$/);\n    const endRowMatch = end.match(/^([1-9]\\d{0,6}|10000000)$/);\n\n    if (startRowMatch && endRowMatch && startRowMatch[1] && endRowMatch[1]) {\n      const startRow = parseInt(startRowMatch[1], 10);\n      const endRow = parseInt(endRowMatch[1], 10);\n      return {\n        type: 'row',\n        startRow,\n        endRow,\n      };\n    }\n  }\n\n  throw new Error(`Unable to parse A1 notation: ${notation}`);\n}\n\n/**\n * Converts a range reference back to A1 notation\n */\nexport function rangeToA1Notation(range: RangeReference): string {\n  switch (range.type) {\n    case 'cell':\n      if (!range.startCell) throw new Error('Invalid cell range: missing startCell');\n      return `${range.startCell.column}${range.startCell.row}`;\n\n    case 'range':\n      if (!range.startCell || !range.endCell) throw new Error('Invalid range: missing start or end cell');\n      return `${range.startCell.column}${range.startCell.row}:${range.endCell.column}${range.endCell.row}`;\n\n    case 'column':\n      if (!range.startColumn || !range.endColumn) throw new Error('Invalid column range: missing start or end column');\n      if (range.startColumn === range.endColumn) {\n        return range.startColumn;\n      }\n      return `${range.startColumn}:${range.endColumn}`;\n\n    case 'row':\n      if (range.startRow === undefined || range.endRow === undefined) throw new Error('Invalid row range: missing start or end row');\n      if (range.startRow === range.endRow) {\n        return range.startRow.toString();\n      }\n      return `${range.startRow}:${range.endRow}`;\n\n    default:\n      throw new Error(`Unknown range type: ${(range as { type: unknown }).type}`);\n  }\n}\n\n/**\n * Cell Count and Dimension Calculation Utilities\n */\n\n/**\n * Calculates the dimensions of a range\n */\nexport function calculateRangeDimensions(notation: string): RangeDimensions {\n  const range = parseA1Notation(notation);\n\n  switch (range.type) {\n    case 'cell':\n      return { rows: 1, columns: 1, cells: 1 };\n\n    case 'range': {\n      if (!range.startCell || !range.endCell) throw new Error('Invalid range: missing cells');\n      const rows = range.endCell.row - range.startCell.row + 1;\n      const columns = range.endCell.columnIndex - range.startCell.columnIndex + 1;\n      return { rows, columns, cells: rows * columns };\n    }\n\n    case 'column': {\n      if (range.startColumnIndex === undefined || range.endColumnIndex === undefined) {\n        throw new Error('Invalid column range: missing column indices');\n      }\n      const columnCount = range.endColumnIndex - range.startColumnIndex + 1;\n      return {\n        rows: GOOGLE_SHEETS_LIMITS.MAX_ROWS,\n        columns: columnCount,\n        cells: GOOGLE_SHEETS_LIMITS.MAX_ROWS * columnCount,\n      };\n    }\n\n    case 'row': {\n      if (range.startRow === undefined || range.endRow === undefined) {\n        throw new Error('Invalid row range: missing row numbers');\n      }\n      const rowCount = range.endRow - range.startRow + 1;\n      return {\n        rows: rowCount,\n        columns: GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n        cells: rowCount * GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n      };\n    }\n\n    default:\n      throw new Error(`Unknown range type: ${(range as { type: string }).type}`);\n  }\n}\n\n/**\n * Calculates total cells affected by multiple ranges\n */\nexport function calculateTotalCells(ranges: string[]): number {\n  return ranges.reduce((total, range) => {\n    const dimensions = calculateRangeDimensions(range);\n    return total + dimensions.cells;\n  }, 0);\n}\n\n/**\n * Batch Operation Builders for Google API\n */\n\n/**\n * Builds a values batch update request for Google Sheets API\n */\nexport function buildValuesBatchUpdateRequest(\n  requests: Array<{\n    range: string;\n    values: (string | number | boolean | null | undefined)[][];\n    majorDimension?: 'ROWS' | 'COLUMNS';\n  }>,\n  sheetTitle: string,\n  options: {\n    valueInputOption?: 'RAW' | 'USER_ENTERED';\n    includeValuesInResponse?: boolean;\n    responseDateTimeRenderOption?: 'FORMATTED_STRING' | 'SERIAL_NUMBER';\n    responseValueRenderOption?: 'FORMATTED_VALUE' | 'UNFORMATTED_VALUE' | 'FORMULA';\n  } = {}\n) {\n  // Validate all ranges first\n  requests.forEach((req, index) => {\n    try {\n      validateA1Notation(req.range);\n    } catch (error) {\n      throw new Error(`Invalid range in request ${index}: ${error}`);\n    }\n  });\n\n  // Calculate total cells for validation\n  const totalCells = calculateTotalCells(requests.map((r) => r.range));\n  if (totalCells > GOOGLE_SHEETS_LIMITS.MAX_CELLS) {\n    throw new Error(`Batch update exceeds maximum cells limit: ${totalCells} > ${GOOGLE_SHEETS_LIMITS.MAX_CELLS}`);\n  }\n\n  // Build the request\n  const data = requests.map((req) => ({\n    range: `${sheetTitle}!${req.range}`,\n    values: req.values,\n    majorDimension: req.majorDimension || 'ROWS',\n  }));\n\n  return {\n    valueInputOption: options.valueInputOption || 'USER_ENTERED',\n    data,\n    includeValuesInResponse: options.includeValuesInResponse || false,\n    responseDateTimeRenderOption: options.responseDateTimeRenderOption || 'FORMATTED_STRING',\n    responseValueRenderOption: options.responseValueRenderOption || 'FORMATTED_VALUE',\n  };\n}\n\n/**\n * Range Conflict Detection\n */\n\n/**\n * Checks if two ranges overlap\n */\nexport function rangesOverlap(range1: string, range2: string): boolean {\n  try {\n    const parsed1 = parseA1Notation(range1);\n    const parsed2 = parseA1Notation(range2);\n\n    // Different types might still overlap, so we need to normalize to cell ranges\n    const normalized1 = normalizeRangeToBounds(parsed1);\n    const normalized2 = normalizeRangeToBounds(parsed2);\n\n    // Check for overlap\n    return !(normalized1.endRow < normalized2.startRow || normalized2.endRow < normalized1.startRow || normalized1.endCol < normalized2.startCol || normalized2.endCol < normalized1.startCol);\n  } catch {\n    // If we can't parse the ranges, assume no overlap\n    return false;\n  }\n}\n\n/**\n * Normalizes a range to bounds for overlap checking\n */\nfunction normalizeRangeToBounds(range: RangeReference): {\n  startRow: number;\n  endRow: number;\n  startCol: number;\n  endCol: number;\n} {\n  switch (range.type) {\n    case 'cell':\n      if (!range.startCell) throw new Error('Invalid cell range');\n      return {\n        startRow: range.startCell.row,\n        endRow: range.startCell.row,\n        startCol: range.startCell.columnIndex,\n        endCol: range.startCell.columnIndex,\n      };\n\n    case 'range':\n      if (!range.startCell || !range.endCell) throw new Error('Invalid range');\n      return {\n        startRow: range.startCell.row,\n        endRow: range.endCell.row,\n        startCol: range.startCell.columnIndex,\n        endCol: range.endCell.columnIndex,\n      };\n\n    case 'column':\n      if (range.startColumnIndex === undefined || range.endColumnIndex === undefined) {\n        throw new Error('Invalid column range');\n      }\n      return {\n        startRow: 1,\n        endRow: GOOGLE_SHEETS_LIMITS.MAX_ROWS,\n        startCol: range.startColumnIndex,\n        endCol: range.endColumnIndex,\n      };\n\n    case 'row':\n      if (range.startRow === undefined || range.endRow === undefined) {\n        throw new Error('Invalid row range');\n      }\n      return {\n        startRow: range.startRow,\n        endRow: range.endRow,\n        startCol: 1,\n        endCol: GOOGLE_SHEETS_LIMITS.MAX_COLUMNS,\n      };\n\n    default:\n      throw new Error(`Unknown range type: ${(range as { type: unknown }).type}`);\n  }\n}\n\n/**\n * Detects conflicts between multiple ranges\n */\nexport function detectRangeConflicts(ranges: string[]): RangeConflict[] {\n  const conflicts: RangeConflict[] = [];\n\n  for (let i = 0; i < ranges.length; i++) {\n    for (let j = i + 1; j < ranges.length; j++) {\n      const range1 = ranges[i];\n      const range2 = ranges[j];\n\n      if (!range1 || !range2) continue;\n\n      if (rangesOverlap(range1, range2)) {\n        conflicts.push({\n          range1,\n          range2,\n          conflictType: 'overlap',\n          description: `Ranges ${range1} and ${range2} overlap`,\n        });\n      }\n    }\n  }\n\n  return conflicts;\n}\n\n/**\n * Validates that a batch of ranges doesn't exceed Google Sheets limits\n */\nexport function validateBatchRanges(ranges: string[]): {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n  totalCells: number;\n} {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  let totalCells = 0;\n\n  // Validate each range\n  ranges.forEach((range, index) => {\n    try {\n      validateA1Notation(range);\n      const dimensions = calculateRangeDimensions(range);\n      totalCells += dimensions.cells;\n\n      // Check for very large ranges that might cause performance issues\n      if (dimensions.cells > 1_000_000) {\n        warnings.push(`Range ${index + 1} (${range}) affects ${dimensions.cells.toLocaleString()} cells, which may impact performance`);\n      }\n    } catch (error) {\n      errors.push(`Range ${index + 1} (${range}): ${error}`);\n    }\n  });\n\n  // Check batch size limits\n  if (ranges.length > GOOGLE_SHEETS_LIMITS.MAX_BATCH_REQUESTS) {\n    errors.push(`Too many ranges: ${ranges.length} > ${GOOGLE_SHEETS_LIMITS.MAX_BATCH_REQUESTS}`);\n  }\n\n  // Check total cells limit\n  if (totalCells > GOOGLE_SHEETS_LIMITS.MAX_CELLS) {\n    errors.push(`Total cells exceed limit: ${totalCells.toLocaleString()} > ${GOOGLE_SHEETS_LIMITS.MAX_CELLS.toLocaleString()}`);\n  }\n\n  // Check for conflicts\n  const conflicts = detectRangeConflicts(ranges);\n  conflicts.forEach((conflict) => {\n    warnings.push(conflict.description);\n  });\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n    totalCells,\n  };\n}\n\n/**\n * Utility Functions for Common Range Operations\n */\n\n/**\n * Expands a range by a specified number of rows and columns\n */\nexport function expandRange(notation: string, expandRows: number, expandCols: number): string {\n  const range = parseA1Notation(notation);\n\n  if (range.type === 'cell' && range.startCell) {\n    const newEndRow = Math.min(range.startCell.row + expandRows, GOOGLE_SHEETS_LIMITS.MAX_ROWS);\n    const newEndCol = Math.min(range.startCell.columnIndex + expandCols, GOOGLE_SHEETS_LIMITS.MAX_COLUMNS);\n    const newEndColStr = columnIndexToString(newEndCol);\n\n    if (expandRows === 0 && expandCols === 0) {\n      return notation;\n    }\n\n    return `${range.startCell.column}${range.startCell.row}:${newEndColStr}${newEndRow}`;\n  }\n\n  if (range.type === 'range' && range.startCell && range.endCell) {\n    const newEndRow = Math.min(range.endCell.row + expandRows, GOOGLE_SHEETS_LIMITS.MAX_ROWS);\n    const newEndCol = Math.min(range.endCell.columnIndex + expandCols, GOOGLE_SHEETS_LIMITS.MAX_COLUMNS);\n    const newEndColStr = columnIndexToString(newEndCol);\n\n    return `${range.startCell.column}${range.startCell.row}:${newEndColStr}${newEndRow}`;\n  }\n\n  // For row and column ranges, expansion doesn't make sense in the same way\n  return notation;\n}\n\n/**\n * Gets the intersection of two ranges\n */\nexport function getRangeIntersection(range1: string, range2: string): string | null {\n  try {\n    const parsed1 = parseA1Notation(range1);\n    const parsed2 = parseA1Notation(range2);\n\n    const bounds1 = normalizeRangeToBounds(parsed1);\n    const bounds2 = normalizeRangeToBounds(parsed2);\n\n    // Check if they overlap\n    if (!rangesOverlap(range1, range2)) {\n      return null;\n    }\n\n    // Calculate intersection bounds\n    const startRow = Math.max(bounds1.startRow, bounds2.startRow);\n    const endRow = Math.min(bounds1.endRow, bounds2.endRow);\n    const startCol = Math.max(bounds1.startCol, bounds2.startCol);\n    const endCol = Math.min(bounds1.endCol, bounds2.endCol);\n\n    const startColStr = columnIndexToString(startCol);\n    const endColStr = columnIndexToString(endCol);\n\n    if (startRow === endRow && startCol === endCol) {\n      return `${startColStr}${startRow}`;\n    }\n\n    return `${startColStr}${startRow}:${endColStr}${endRow}`;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Splits a large range into smaller chunks for batch processing\n */\nexport function splitRangeIntoChunks(notation: string, maxCellsPerChunk = 100_000): string[] {\n  const range = parseA1Notation(notation);\n  const dimensions = calculateRangeDimensions(notation);\n\n  if (dimensions.cells <= maxCellsPerChunk) {\n    return [notation];\n  }\n\n  const chunks: string[] = [];\n\n  if (range.type === 'range' && range.startCell && range.endCell) {\n    const totalRows = range.endCell.row - range.startCell.row + 1;\n    const totalCols = range.endCell.columnIndex - range.startCell.columnIndex + 1;\n\n    // Calculate chunk size based on max cells\n    const cellsPerRow = totalCols;\n    const maxRowsPerChunk = Math.floor(maxCellsPerChunk / cellsPerRow);\n\n    if (maxRowsPerChunk >= 1) {\n      // Split by rows\n      for (let currentRow = range.startCell.row; currentRow <= range.endCell.row; currentRow += maxRowsPerChunk) {\n        const chunkEndRow = Math.min(currentRow + maxRowsPerChunk - 1, range.endCell.row);\n        const chunkRange = `${range.startCell.column}${currentRow}:${range.endCell.column}${chunkEndRow}`;\n        chunks.push(chunkRange);\n      }\n    } else {\n      // If even one row is too big, split by columns\n      const maxColsPerChunk = Math.floor(maxCellsPerChunk / totalRows);\n\n      for (let currentCol = range.startCell.columnIndex; currentCol <= range.endCell.columnIndex; currentCol += maxColsPerChunk) {\n        const chunkEndCol = Math.min(currentCol + maxColsPerChunk - 1, range.endCell.columnIndex);\n        const startColStr = columnIndexToString(currentCol);\n        const endColStr = columnIndexToString(chunkEndCol);\n        const chunkRange = `${startColStr}${range.startCell.row}:${endColStr}${range.endCell.row}`;\n        chunks.push(chunkRange);\n      }\n    }\n  } else {\n    // For other range types, just return the original range\n    // (column and row ranges are already at their limits)\n    chunks.push(notation);\n  }\n\n  return chunks;\n}\n\n/**\n * Converts a RangeReference to Google Sheets API GridRange format\n *\n * This handles the different range types correctly:\n * - 'cell' and 'range' types: Extract indices from startCell/endCell\n * - 'row' types: Use startRow/endRow, omit column indices for full row\n * - 'column' types: Use startColumnIndex/endColumnIndex, omit row indices for full column\n *\n * Important: Google Sheets API uses 0-based indices, while A1 notation uses 1-based indices.\n * This function handles the conversion properly for each range type.\n */\nexport function rangeReferenceToGridRange(\n  rangeRef: RangeReference,\n  sheetId: number\n): {\n  sheetId: number;\n  startRowIndex?: number;\n  endRowIndex?: number;\n  startColumnIndex?: number;\n  endColumnIndex?: number;\n} {\n  if (rangeRef.type === 'cell' || rangeRef.type === 'range') {\n    // For cell and range types, extract from startCell/endCell\n    if (!rangeRef.startCell || !rangeRef.endCell) {\n      throw new Error(`Invalid ${rangeRef.type} range: missing start or end cell`);\n    }\n\n    return {\n      sheetId,\n      // Convert 1-based row to 0-based startRowIndex\n      startRowIndex: rangeRef.startCell.row - 1,\n      // endRowIndex is exclusive (so row 5 becomes endRowIndex 5)\n      endRowIndex: rangeRef.endCell.row,\n      // Convert 1-based column index to 0-based startColumnIndex\n      startColumnIndex: rangeRef.startCell.columnIndex - 1,\n      // endColumnIndex is exclusive\n      endColumnIndex: rangeRef.endCell.columnIndex,\n    };\n  }\n  if (rangeRef.type === 'row') {\n    // For row types, use startRow/endRow and omit column indices for full row width\n    if (rangeRef.startRow === undefined || rangeRef.endRow === undefined) {\n      throw new Error('Invalid row range: missing start or end row');\n    }\n\n    return {\n      sheetId,\n      // Convert 1-based row to 0-based startRowIndex\n      startRowIndex: rangeRef.startRow - 1,\n      // endRowIndex is exclusive\n      endRowIndex: rangeRef.endRow,\n      // Omit startColumnIndex and endColumnIndex to apply to all columns\n    };\n  }\n  if (rangeRef.type === 'column') {\n    // For column types, use startColumnIndex/endColumnIndex and omit row indices for full column height\n    if (rangeRef.startColumnIndex === undefined || rangeRef.endColumnIndex === undefined) {\n      throw new Error('Invalid column range: missing start or end column index');\n    }\n\n    return {\n      sheetId,\n      // Omit startRowIndex and endRowIndex to apply to all rows\n      // Convert 1-based column index to 0-based startColumnIndex\n      startColumnIndex: rangeRef.startColumnIndex - 1,\n      // endColumnIndex is exclusive\n      endColumnIndex: rangeRef.endColumnIndex,\n    };\n  }\n\n  throw new Error(`Unknown range type: ${(rangeRef as { type: unknown }).type}`);\n}\n"],"names":["a1Col","GOOGLE_SHEETS_LIMITS","MAX_ROWS","MAX_COLUMNS","MAX_CELLS","MAX_BATCH_REQUESTS","MAX_DIMENSION_BATCH_REQUESTS","isValidA1Notation","notation","a1Pattern","test","parts","split","part","cellMatch","match","colStr","rowStr","colNum","columnStringToIndex","rowNum","parseInt","colMatch","rowMatch","validateA1Notation","Error","i","length","charCodeAt","columnIndexToString","colIndex","parseCellReference","cellRef","column","row","columnIndex","parseA1Notation","startCell","type","endCell","startColumn","endColumn","startColumnIndex","endColumnIndex","startRow","endRow","start","end","startCellMatch","endCellMatch","startColMatch","endColMatch","startRowMatch","endRowMatch","rangeToA1Notation","range","undefined","toString","calculateRangeDimensions","rows","columns","cells","columnCount","rowCount","calculateTotalCells","ranges","reduce","total","dimensions","buildValuesBatchUpdateRequest","requests","sheetTitle","options","forEach","req","index","error","totalCells","map","r","data","values","majorDimension","valueInputOption","includeValuesInResponse","responseDateTimeRenderOption","responseValueRenderOption","rangesOverlap","range1","range2","parsed1","parsed2","normalized1","normalizeRangeToBounds","normalized2","endCol","startCol","detectRangeConflicts","conflicts","j","push","conflictType","description","validateBatchRanges","errors","warnings","toLocaleString","conflict","valid","expandRange","expandRows","expandCols","newEndRow","Math","min","newEndCol","newEndColStr","getRangeIntersection","bounds1","bounds2","max","startColStr","endColStr","splitRangeIntoChunks","maxCellsPerChunk","chunks","totalRows","totalCols","cellsPerRow","maxRowsPerChunk","floor","currentRow","chunkEndRow","chunkRange","maxColsPerChunk","currentCol","chunkEndCol","rangeReferenceToGridRange","rangeRef","sheetId","startRowIndex","endRowIndex"],"mappings":"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"}

package/dist/esm/spreadsheet/sheet-operations.d.ts

@@ -5,7 +5,7 @@ export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string
     sheetGUID?: string;
     headersEnsured?: boolean;
 }>;
-export declare function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger): Promise<sheets_v4.Schema$Sheet>;
+export declare function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger): Promise<sheets_v4.Schema$Sheet | null>;
 export declare function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: {
     spreadsheetId: string;
     sheetTitle: string;