@mcp-z/mcp-sheets 2.6.0 → 2.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/dist/cjs/mcp/tools/columns-update.js +5 -1
  2. package/dist/cjs/mcp/tools/columns-update.js.map +1 -1
  3. package/dist/cjs/mcp/tools/rows-append.js +1 -2
  4. package/dist/cjs/mcp/tools/rows-append.js.map +1 -1
  5. package/dist/cjs/mcp/tools/rows-csv-append.js +1 -2
  6. package/dist/cjs/mcp/tools/rows-csv-append.js.map +1 -1
  7. package/dist/cjs/spreadsheet/data-operations.d.cts +8 -1
  8. package/dist/cjs/spreadsheet/data-operations.d.ts +8 -1
  9. package/dist/cjs/spreadsheet/data-operations.js +79 -101
  10. package/dist/cjs/spreadsheet/data-operations.js.map +1 -1
  11. package/dist/cjs/spreadsheet/range-operations.d.cts +0 -67
  12. package/dist/cjs/spreadsheet/range-operations.d.ts +0 -67
  13. package/dist/cjs/spreadsheet/range-operations.js +0 -236
  14. package/dist/cjs/spreadsheet/range-operations.js.map +1 -1
  15. package/dist/cjs/spreadsheet/sheet-operations.d.cts +4 -17
  16. package/dist/cjs/spreadsheet/sheet-operations.d.ts +4 -17
  17. package/dist/cjs/spreadsheet/sheet-operations.js +17 -221
  18. package/dist/cjs/spreadsheet/sheet-operations.js.map +1 -1
  19. package/dist/esm/mcp/tools/columns-update.js +5 -1
  20. package/dist/esm/mcp/tools/columns-update.js.map +1 -1
  21. package/dist/esm/mcp/tools/rows-append.js +1 -2
  22. package/dist/esm/mcp/tools/rows-append.js.map +1 -1
  23. package/dist/esm/mcp/tools/rows-csv-append.js +1 -2
  24. package/dist/esm/mcp/tools/rows-csv-append.js.map +1 -1
  25. package/dist/esm/spreadsheet/data-operations.d.ts +8 -1
  26. package/dist/esm/spreadsheet/data-operations.js +27 -35
  27. package/dist/esm/spreadsheet/data-operations.js.map +1 -1
  28. package/dist/esm/spreadsheet/range-operations.d.ts +0 -67
  29. package/dist/esm/spreadsheet/range-operations.js +0 -227
  30. package/dist/esm/spreadsheet/range-operations.js.map +1 -1
  31. package/dist/esm/spreadsheet/sheet-operations.d.ts +4 -17
  32. package/dist/esm/spreadsheet/sheet-operations.js +7 -115
  33. package/dist/esm/spreadsheet/sheet-operations.js.map +1 -1
  34. package/package.json +1 -1
@@ -49,15 +49,6 @@ export interface RangeDimensions {
49
49
  columns: number;
50
50
  cells: number;
51
51
  }
52
- /**
53
- * Represents a range conflict between two ranges
54
- */
55
- export interface RangeConflict {
56
- range1: string;
57
- range2: string;
58
- conflictType: 'overlap' | 'contains' | 'contained' | 'adjacent';
59
- description: string;
60
- }
61
52
  /**
62
53
  * A1 Notation Validation Utilities
63
54
  */
@@ -103,64 +94,6 @@ export declare function calculateRangeDimensions(notation: string): RangeDimensi
103
94
  * Counts cells in a finite sheet-local range, rejecting reversed bounds.
104
95
  */
105
96
  export declare function calculateFiniteRangeCellCount(notation: string): number;
106
- export declare function calculateTotalCells(ranges: string[]): number;
107
- /**
108
- * Batch Operation Builders for Google API
109
- */
110
- /**
111
- * Builds a values batch update request for Google Sheets API
112
- */
113
- export declare function buildValuesBatchUpdateRequest(requests: Array<{
114
- range: string;
115
- values: (string | number | boolean | null | undefined)[][];
116
- majorDimension?: 'ROWS' | 'COLUMNS';
117
- }>, sheetTitle: string, options?: {
118
- valueInputOption?: 'RAW' | 'USER_ENTERED';
119
- includeValuesInResponse?: boolean;
120
- responseDateTimeRenderOption?: 'FORMATTED_STRING' | 'SERIAL_NUMBER';
121
- responseValueRenderOption?: 'FORMATTED_VALUE' | 'UNFORMATTED_VALUE' | 'FORMULA';
122
- }): {
123
- valueInputOption: "RAW" | "USER_ENTERED";
124
- data: {
125
- range: string;
126
- values: (string | number | boolean | null | undefined)[][];
127
- majorDimension: "ROWS" | "COLUMNS";
128
- }[];
129
- includeValuesInResponse: boolean;
130
- responseDateTimeRenderOption: "FORMATTED_STRING" | "SERIAL_NUMBER";
131
- responseValueRenderOption: "UNFORMATTED_VALUE" | "FORMATTED_VALUE" | "FORMULA";
132
- };
133
- /**
134
- * Range Conflict Detection
135
- */
136
- /**
137
- * Checks if two ranges overlap
138
- */
139
- export declare function rangesOverlap(range1: string, range2: string): boolean;
140
- /**
141
- * Detects conflicts between multiple ranges
142
- */
143
- export declare function detectRangeConflicts(ranges: string[]): RangeConflict[];
144
- /**
145
- * Validates that a batch of ranges doesn't exceed Google Sheets limits
146
- */
147
- export declare function validateBatchRanges(ranges: string[]): {
148
- valid: boolean;
149
- errors: string[];
150
- warnings: string[];
151
- totalCells: number;
152
- };
153
- /**
154
- * Utility Functions for Common Range Operations
155
- */
156
- /**
157
- * Expands a range by a specified number of rows and columns
158
- */
159
- export declare function expandRange(notation: string, expandRows: number, expandCols: number): string;
160
- /**
161
- * Splits a large range into smaller chunks for batch processing
162
- */
163
- export declare function splitRangeIntoChunks(notation: string, maxCellsPerChunk?: number): string[];
164
97
  /**
165
98
  * Converts a RangeReference to Google Sheets API GridRange format
166
99
  *
@@ -287,233 +287,6 @@ export const GOOGLE_SHEETS_LIMITS = {
287
287
  if (dimensions.rows < 1 || dimensions.columns < 1) throw new Error(`Range end must not precede its start: ${notation}`);
288
288
  return dimensions.cells;
289
289
  }
290
- export function calculateTotalCells(ranges) {
291
- return ranges.reduce((total, range)=>{
292
- const dimensions = calculateRangeDimensions(range);
293
- return total + dimensions.cells;
294
- }, 0);
295
- }
296
- /**
297
- * Batch Operation Builders for Google API
298
- */ /**
299
- * Builds a values batch update request for Google Sheets API
300
- */ export function buildValuesBatchUpdateRequest(requests, sheetTitle, options = {}) {
301
- // Validate all ranges first
302
- requests.forEach((req, index)=>{
303
- try {
304
- validateA1Notation(req.range);
305
- } catch (error) {
306
- throw new Error(`Invalid range in request ${index}: ${error}`);
307
- }
308
- });
309
- // Calculate total cells for validation
310
- const totalCells = calculateTotalCells(requests.map((r)=>r.range));
311
- if (totalCells > GOOGLE_SHEETS_LIMITS.MAX_CELLS) {
312
- throw new Error(`Batch update exceeds maximum cells limit: ${totalCells} > ${GOOGLE_SHEETS_LIMITS.MAX_CELLS}`);
313
- }
314
- // Build the request
315
- const data = requests.map((req)=>({
316
- range: `${sheetTitle}!${req.range}`,
317
- values: req.values,
318
- majorDimension: req.majorDimension || 'ROWS'
319
- }));
320
- return {
321
- valueInputOption: options.valueInputOption || 'USER_ENTERED',
322
- data,
323
- includeValuesInResponse: options.includeValuesInResponse || false,
324
- responseDateTimeRenderOption: options.responseDateTimeRenderOption || 'FORMATTED_STRING',
325
- responseValueRenderOption: options.responseValueRenderOption || 'FORMATTED_VALUE'
326
- };
327
- }
328
- /**
329
- * Range Conflict Detection
330
- */ /**
331
- * Checks if two ranges overlap
332
- */ export function rangesOverlap(range1, range2) {
333
- try {
334
- const parsed1 = parseA1Notation(range1);
335
- const parsed2 = parseA1Notation(range2);
336
- // Different types might still overlap, so we need to normalize to cell ranges
337
- const normalized1 = normalizeRangeToBounds(parsed1);
338
- const normalized2 = normalizeRangeToBounds(parsed2);
339
- // Check for overlap
340
- return !(normalized1.endRow < normalized2.startRow || normalized2.endRow < normalized1.startRow || normalized1.endCol < normalized2.startCol || normalized2.endCol < normalized1.startCol);
341
- } catch {
342
- // If we can't parse the ranges, assume no overlap
343
- return false;
344
- }
345
- }
346
- /**
347
- * Normalizes a range to bounds for overlap checking
348
- */ function normalizeRangeToBounds(range) {
349
- switch(range.type){
350
- case 'cell':
351
- if (!range.startCell) throw new Error('Invalid cell range');
352
- return {
353
- startRow: range.startCell.row,
354
- endRow: range.startCell.row,
355
- startCol: range.startCell.columnIndex,
356
- endCol: range.startCell.columnIndex
357
- };
358
- case 'range':
359
- if (!range.startCell || !range.endCell) throw new Error('Invalid range');
360
- return {
361
- startRow: range.startCell.row,
362
- endRow: range.endCell.row,
363
- startCol: range.startCell.columnIndex,
364
- endCol: range.endCell.columnIndex
365
- };
366
- case 'column':
367
- if (range.startColumnIndex === undefined || range.endColumnIndex === undefined) {
368
- throw new Error('Invalid column range');
369
- }
370
- return {
371
- startRow: 1,
372
- endRow: GOOGLE_SHEETS_LIMITS.MAX_ROWS,
373
- startCol: range.startColumnIndex,
374
- endCol: range.endColumnIndex
375
- };
376
- case 'row':
377
- if (range.startRow === undefined || range.endRow === undefined) {
378
- throw new Error('Invalid row range');
379
- }
380
- return {
381
- startRow: range.startRow,
382
- endRow: range.endRow,
383
- startCol: 1,
384
- endCol: GOOGLE_SHEETS_LIMITS.MAX_COLUMNS
385
- };
386
- default:
387
- throw new Error(`Unknown range type: ${range.type}`);
388
- }
389
- }
390
- /**
391
- * Detects conflicts between multiple ranges
392
- */ export function detectRangeConflicts(ranges) {
393
- const conflicts = [];
394
- for(let i = 0; i < ranges.length; i++){
395
- for(let j = i + 1; j < ranges.length; j++){
396
- const range1 = ranges[i];
397
- const range2 = ranges[j];
398
- if (!range1 || !range2) continue;
399
- if (rangesOverlap(range1, range2)) {
400
- conflicts.push({
401
- range1,
402
- range2,
403
- conflictType: 'overlap',
404
- description: `Ranges ${range1} and ${range2} overlap`
405
- });
406
- }
407
- }
408
- }
409
- return conflicts;
410
- }
411
- /**
412
- * Validates that a batch of ranges doesn't exceed Google Sheets limits
413
- */ export function validateBatchRanges(ranges) {
414
- const errors = [];
415
- const warnings = [];
416
- let totalCells = 0;
417
- // Validate each range
418
- ranges.forEach((range, index)=>{
419
- try {
420
- validateA1Notation(range);
421
- const dimensions = calculateRangeDimensions(range);
422
- totalCells += dimensions.cells;
423
- // Check for very large ranges that might cause performance issues
424
- if (dimensions.cells > 1000000) {
425
- warnings.push(`Range ${index + 1} (${range}) affects ${dimensions.cells.toLocaleString()} cells, which may impact performance`);
426
- }
427
- } catch (error) {
428
- errors.push(`Range ${index + 1} (${range}): ${error}`);
429
- }
430
- });
431
- // Check batch size limits
432
- if (ranges.length > GOOGLE_SHEETS_LIMITS.MAX_BATCH_REQUESTS) {
433
- errors.push(`Too many ranges: ${ranges.length} > ${GOOGLE_SHEETS_LIMITS.MAX_BATCH_REQUESTS}`);
434
- }
435
- // Check total cells limit
436
- if (totalCells > GOOGLE_SHEETS_LIMITS.MAX_CELLS) {
437
- errors.push(`Total cells exceed limit: ${totalCells.toLocaleString()} > ${GOOGLE_SHEETS_LIMITS.MAX_CELLS.toLocaleString()}`);
438
- }
439
- // Check for conflicts
440
- const conflicts = detectRangeConflicts(ranges);
441
- conflicts.forEach((conflict)=>{
442
- warnings.push(conflict.description);
443
- });
444
- return {
445
- valid: errors.length === 0,
446
- errors,
447
- warnings,
448
- totalCells
449
- };
450
- }
451
- /**
452
- * Utility Functions for Common Range Operations
453
- */ /**
454
- * Expands a range by a specified number of rows and columns
455
- */ export function expandRange(notation, expandRows, expandCols) {
456
- const range = parseA1Notation(notation);
457
- if (range.type === 'cell' && range.startCell) {
458
- const newEndRow = Math.min(range.startCell.row + expandRows, GOOGLE_SHEETS_LIMITS.MAX_ROWS);
459
- const newEndCol = Math.min(range.startCell.columnIndex + expandCols, GOOGLE_SHEETS_LIMITS.MAX_COLUMNS);
460
- const newEndColStr = columnIndexToString(newEndCol);
461
- if (expandRows === 0 && expandCols === 0) {
462
- return notation;
463
- }
464
- return `${range.startCell.column}${range.startCell.row}:${newEndColStr}${newEndRow}`;
465
- }
466
- if (range.type === 'range' && range.startCell && range.endCell) {
467
- const newEndRow = Math.min(range.endCell.row + expandRows, GOOGLE_SHEETS_LIMITS.MAX_ROWS);
468
- const newEndCol = Math.min(range.endCell.columnIndex + expandCols, GOOGLE_SHEETS_LIMITS.MAX_COLUMNS);
469
- const newEndColStr = columnIndexToString(newEndCol);
470
- return `${range.startCell.column}${range.startCell.row}:${newEndColStr}${newEndRow}`;
471
- }
472
- // For row and column ranges, expansion doesn't make sense in the same way
473
- return notation;
474
- }
475
- /**
476
- * Splits a large range into smaller chunks for batch processing
477
- */ export function splitRangeIntoChunks(notation, maxCellsPerChunk = 100000) {
478
- const range = parseA1Notation(notation);
479
- const dimensions = calculateRangeDimensions(notation);
480
- if (dimensions.cells <= maxCellsPerChunk) {
481
- return [
482
- notation
483
- ];
484
- }
485
- const chunks = [];
486
- if (range.type === 'range' && range.startCell && range.endCell) {
487
- const totalRows = range.endCell.row - range.startCell.row + 1;
488
- const totalCols = range.endCell.columnIndex - range.startCell.columnIndex + 1;
489
- // Calculate chunk size based on max cells
490
- const cellsPerRow = totalCols;
491
- const maxRowsPerChunk = Math.floor(maxCellsPerChunk / cellsPerRow);
492
- if (maxRowsPerChunk >= 1) {
493
- // Split by rows
494
- for(let currentRow = range.startCell.row; currentRow <= range.endCell.row; currentRow += maxRowsPerChunk){
495
- const chunkEndRow = Math.min(currentRow + maxRowsPerChunk - 1, range.endCell.row);
496
- const chunkRange = `${range.startCell.column}${currentRow}:${range.endCell.column}${chunkEndRow}`;
497
- chunks.push(chunkRange);
498
- }
499
- } else {
500
- // If even one row is too big, split by columns
501
- const maxColsPerChunk = Math.floor(maxCellsPerChunk / totalRows);
502
- for(let currentCol = range.startCell.columnIndex; currentCol <= range.endCell.columnIndex; currentCol += maxColsPerChunk){
503
- const chunkEndCol = Math.min(currentCol + maxColsPerChunk - 1, range.endCell.columnIndex);
504
- const startColStr = columnIndexToString(currentCol);
505
- const endColStr = columnIndexToString(chunkEndCol);
506
- const chunkRange = `${startColStr}${range.startCell.row}:${endColStr}${range.endCell.row}`;
507
- chunks.push(chunkRange);
508
- }
509
- }
510
- } else {
511
- // For other range types, just return the original range
512
- // (column and row ranges are already at their limits)
513
- chunks.push(notation);
514
- }
515
- return chunks;
516
- }
517
290
  /**
518
291
  * Converts a RangeReference to Google Sheets API GridRange format
519
292
  *
@@ -1 +1 @@
1
- {"version":3,"sources":["/Users/kevin/Dev/open-source/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 * Counts cells in a finite sheet-local range, rejecting reversed bounds.\n */\nexport function calculateFiniteRangeCellCount(notation: string): number {\n const range = parseA1Notation(notation);\n if (range.type !== 'cell' && range.type !== 'range') {\n throw new Error(`Range must have finite start and end rows and columns: ${notation}`);\n }\n const dimensions = calculateRangeDimensions(notation);\n if (dimensions.rows < 1 || dimensions.columns < 1) throw new Error(`Range end must not precede its start: ${notation}`);\n return dimensions.cells;\n}\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 * 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\n/**\n * A finite, sheet-local block of cells with 1-based inclusive bounds.\n */\nexport interface CellBlock {\n startRow: number;\n endRow: number;\n startColumn: number;\n endColumn: number;\n}\n\n/**\n * Parses a finite sheet-local A1 range (cell or range) into 1-based inclusive bounds.\n * Throws for invalid syntax, whole rows/columns and reversed bounds.\n */\nexport function parseFiniteCellBlock(notation: string): CellBlock {\n const range = parseA1Notation(notation);\n if (range.type !== 'cell' && range.type !== 'range') {\n throw new Error(`Range must have finite start and end rows and columns: ${notation}`);\n }\n calculateFiniteRangeCellCount(notation);\n if (!range.startCell || !range.endCell) throw new Error(`Invalid range: ${notation}`);\n return { startRow: range.startCell.row, endRow: range.endCell.row, startColumn: range.startCell.columnIndex, endColumn: range.endCell.columnIndex };\n}\n\n/**\n * Formats a block as A1 notation (a single cell when it spans one cell).\n */\nexport function cellBlockToA1(block: CellBlock): string {\n const start = `${columnIndexToString(block.startColumn)}${block.startRow}`;\n if (block.startRow === block.endRow && block.startColumn === block.endColumn) return start;\n return `${start}:${columnIndexToString(block.endColumn)}${block.endRow}`;\n}\n\n/**\n * Footprint of a copy-paste: the cells written in the destination.\n *\n * - destination is one cell: the (oriented) source size anchored at that cell\n * - destination is a range whose height and width are whole multiples of the oriented source: the destination itself (the source is tiled)\n * - anything else throws\n */\nexport function calculatePasteRange(source: string, destination: string, orientation: 'NORMAL' | 'TRANSPOSE'): CellBlock {\n const src = parseFiniteCellBlock(source);\n const dest = parseFiniteCellBlock(destination);\n const srcRows = src.endRow - src.startRow + 1;\n const srcColumns = src.endColumn - src.startColumn + 1;\n const rows = orientation === 'TRANSPOSE' ? srcColumns : srcRows;\n const columns = orientation === 'TRANSPOSE' ? srcRows : srcColumns;\n const destRows = dest.endRow - dest.startRow + 1;\n const destColumns = dest.endColumn - dest.startColumn + 1;\n\n if (destRows === 1 && destColumns === 1) {\n return { startRow: dest.startRow, endRow: dest.startRow + rows - 1, startColumn: dest.startColumn, endColumn: dest.startColumn + columns - 1 };\n }\n if (destRows % rows === 0 && destColumns % columns === 0) return dest;\n throw new Error(\n `Destination ${destination} is ${destRows}x${destColumns} cells; the ${orientation === 'TRANSPOSE' ? 'transposed ' : ''}source ${source} is ${rows}x${columns}. Use a single anchor cell (e.g., ${columnIndexToString(dest.startColumn)}${dest.startRow}) or a range whose height and width are whole multiples of ${rows}x${columns}.`\n );\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","calculateFiniteRangeCellCount","dimensions","calculateTotalCells","ranges","reduce","total","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","splitRangeIntoChunks","maxCellsPerChunk","chunks","totalRows","totalCols","cellsPerRow","maxRowsPerChunk","floor","currentRow","chunkEndRow","chunkRange","maxColsPerChunk","currentCol","chunkEndCol","startColStr","endColStr","rangeReferenceToGridRange","rangeRef","sheetId","startRowIndex","endRowIndex","parseFiniteCellBlock","cellBlockToA1","block","calculatePasteRange","source","destination","orientation","src","dest","srcRows","srcColumns","destRows","destColumns"],"mappings":"AAAA;;;;;;;;;;;;;CAaC,GAED,SAASA,KAAK,QAAQ,wBAAwB;AAE9C,qCAAqC;AACrC,OAAO,MAAMC,uBAAuB;IAClCC,UAAU;IACVC,aAAa;IACbC,WAAW;IACXC,oBAAoB;IACpBC,8BAA8B;AAChC,EAAW;AA6CX;;CAEC,GAED;;CAEC,GACD,OAAO,SAASC,kBAAkBC,QAAgB;IAChD,IAAI,CAACA,YAAY,OAAOA,aAAa,UAAU;QAC7C,OAAO;IACT;IAEA,8CAA8C;IAC9C,MAAMC,YAAY;IAElB,IAAI,CAACA,UAAUC,IAAI,CAACF,WAAW;QAC7B,OAAO;IACT;IAEA,iDAAiD;IACjD,MAAMG,QAAQH,SAASI,KAAK,CAAC;IAE7B,KAAK,MAAMC,QAAQF,MAAO;QACxB,uBAAuB;QACvB,MAAMG,YAAYD,KAAKE,KAAK,CAAC;QAC7B,IAAID,aAAaA,SAAS,CAAC,EAAE,IAAIA,SAAS,CAAC,EAAE,EAAE;YAC7C,MAAM,GAAGE,QAAQC,OAAO,GAAGH;YAE3B,kBAAkB;YAClB,MAAMI,SAASC,oBAAoBH;YACnC,IAAIE,SAASjB,qBAAqBE,WAAW,EAAE;gBAC7C,OAAO;YACT;YAEA,eAAe;YACf,MAAMiB,SAASC,SAASJ,QAAQ;YAChC,IAAIG,SAASnB,qBAAqBC,QAAQ,EAAE;gBAC1C,OAAO;YACT;QACF;QAEA,yBAAyB;QACzB,MAAMoB,WAAWT,KAAKE,KAAK,CAAC;QAC5B,IAAIO,YAAYA,QAAQ,CAAC,EAAE,EAAE;YAC3B,MAAMJ,SAASC,oBAAoBG,QAAQ,CAAC,EAAE;YAC9C,IAAIJ,SAASjB,qBAAqBE,WAAW,EAAE;gBAC7C,OAAO;YACT;QACF;QAEA,sBAAsB;QACtB,MAAMoB,WAAWV,KAAKE,KAAK,CAAC;QAC5B,IAAIQ,YAAYA,QAAQ,CAAC,EAAE,EAAE;YAC3B,MAAMH,SAASC,SAASE,QAAQ,CAAC,EAAE,EAAE;YACrC,IAAIH,SAASnB,qBAAqBC,QAAQ,EAAE;gBAC1C,OAAO;YACT;QACF;IACF;IAEA,OAAO;AACT;AAEA;;CAEC,GACD,OAAO,SAASsB,mBAAmBhB,QAAgB;IACjD,IAAI,CAACD,kBAAkBC,WAAW;QAChC,MAAM,IAAIiB,MAAM,CAAC,sBAAsB,EAAEjB,SAAS,qCAAqC,CAAC;IAC1F;AACF;AAEA;;CAEC,GAED;;CAEC,GACD,OAAO,SAASW,oBAAoBH,MAAc;IAChD,IAAIE,SAAS;IACb,IAAK,IAAIQ,IAAI,GAAGA,IAAIV,OAAOW,MAAM,EAAED,IAAK;QACtCR,SAASA,SAAS,KAAMF,CAAAA,OAAOY,UAAU,CAACF,KAAK,EAAC;IAClD;IACA,OAAOR;AACT;AAEA;;CAEC,GACD,OAAO,SAASW,oBAAoBC,QAAgB;IAClD,OAAO9B,MAAM8B;AACf;AAEA;;CAEC,GACD,OAAO,SAASC,mBAAmBC,OAAe;IAChD,MAAMjB,QAAQiB,QAAQjB,KAAK,CAAC;IAC5B,IAAI,CAACA,SAAS,CAACA,KAAK,CAAC,EAAE,IAAI,CAACA,KAAK,CAAC,EAAE,EAAE;QACpC,MAAM,IAAIU,MAAM,CAAC,wBAAwB,EAAEO,SAAS;IACtD;IAEA,MAAM,GAAGC,QAAQhB,OAAO,GAAGF;IAC3B,MAAMmB,MAAMb,SAASJ,QAAQ;IAC7B,MAAMkB,cAAchB,oBAAoBc;IAExC,OAAO;QACLA;QACAE;QACAD;IACF;AACF;AAEA;;CAEC,GACD,OAAO,SAASE,gBAAgB5B,QAAgB;IAC9CgB,mBAAmBhB;IAEnB,MAAMG,QAAQH,SAASI,KAAK,CAAC;IAE7B,IAAID,MAAMgB,MAAM,KAAK,GAAG;QACtB,MAAMd,OAAOF,KAAK,CAAC,EAAE;QACrB,IAAI,CAACE,MAAM;YACT,MAAM,IAAIY,MAAM;QAClB;QAEA,mCAAmC;QACnC,MAAMX,YAAYD,KAAKE,KAAK,CAAC;QAC7B,IAAID,aAAaA,SAAS,CAAC,EAAE,IAAIA,SAAS,CAAC,EAAE,EAAE;YAC7C,MAAMuB,YAAYN,mBAAmBlB;YACrC,OAAO;gBACLyB,MAAM;gBACND;gBACAE,SAASF;YACX;QACF;QAEA,oCAAoC;QACpC,MAAMf,WAAWT,KAAKE,KAAK,CAAC;QAC5B,IAAIO,YAAYA,QAAQ,CAAC,EAAE,EAAE;YAC3B,MAAMW,SAASX,QAAQ,CAAC,EAAE;YAC1B,MAAMa,cAAchB,oBAAoBc;YACxC,OAAO;gBACLK,MAAM;gBACNE,aAAaP;gBACbQ,WAAWR;gBACXS,kBAAkBP;gBAClBQ,gBAAgBR;YAClB;QACF;QAEA,iCAAiC;QACjC,MAAMZ,WAAWV,KAAKE,KAAK,CAAC;QAC5B,IAAIQ,YAAYA,QAAQ,CAAC,EAAE,EAAE;YAC3B,MAAMW,MAAMb,SAASE,QAAQ,CAAC,EAAE,EAAE;YAClC,OAAO;gBACLe,MAAM;gBACNM,UAAUV;gBACVW,QAAQX;YACV;QACF;IACF;IAEA,IAAIvB,MAAMgB,MAAM,KAAK,KAAKhB,KAAK,CAAC,EAAE,IAAIA,KAAK,CAAC,EAAE,EAAE;QAC9C,MAAM,CAACmC,OAAOC,IAAI,GAAGpC;QAErB,2BAA2B;QAC3B,MAAMqC,iBAAiBF,MAAM/B,KAAK,CAAC;QACnC,MAAMkC,eAAeF,IAAIhC,KAAK,CAAC;QAE/B,IAAIiC,kBAAkBC,gBAAgBD,cAAc,CAAC,EAAE,IAAIA,cAAc,CAAC,EAAE,IAAIC,YAAY,CAAC,EAAE,IAAIA,YAAY,CAAC,EAAE,EAAE;YAClH,MAAMZ,YAAYN,mBAAmBe;YACrC,MAAMP,UAAUR,mBAAmBgB;YACnC,OAAO;gBACLT,MAAM;gBACND;gBACAE;YACF;QACF;QAEA,2BAA2B;QAC3B,MAAMW,gBAAgBJ,MAAM/B,KAAK,CAAC;QAClC,MAAMoC,cAAcJ,IAAIhC,KAAK,CAAC;QAE9B,IAAImC,iBAAiBC,eAAeD,aAAa,CAAC,EAAE,IAAIC,WAAW,CAAC,EAAE,EAAE;YACtE,MAAMX,cAAcU,aAAa,CAAC,EAAE;YACpC,MAAMT,YAAYU,WAAW,CAAC,EAAE;YAChC,MAAMT,mBAAmBvB,oBAAoBqB;YAC7C,MAAMG,iBAAiBxB,oBAAoBsB;YAC3C,OAAO;gBACLH,MAAM;gBACNE;gBACAC;gBACAC;gBACAC;YACF;QACF;QAEA,wBAAwB;QACxB,MAAMS,gBAAgBN,MAAM/B,KAAK,CAAC;QAClC,MAAMsC,cAAcN,IAAIhC,KAAK,CAAC;QAE9B,IAAIqC,iBAAiBC,eAAeD,aAAa,CAAC,EAAE,IAAIC,WAAW,CAAC,EAAE,EAAE;YACtE,MAAMT,WAAWvB,SAAS+B,aAAa,CAAC,EAAE,EAAE;YAC5C,MAAMP,SAASxB,SAASgC,WAAW,CAAC,EAAE,EAAE;YACxC,OAAO;gBACLf,MAAM;gBACNM;gBACAC;YACF;QACF;IACF;IAEA,MAAM,IAAIpB,MAAM,CAAC,6BAA6B,EAAEjB,UAAU;AAC5D;AAEA;;CAEC,GACD,OAAO,SAAS8C,kBAAkBC,KAAqB;IACrD,OAAQA,MAAMjB,IAAI;QAChB,KAAK;YACH,IAAI,CAACiB,MAAMlB,SAAS,EAAE,MAAM,IAAIZ,MAAM;YACtC,OAAO,GAAG8B,MAAMlB,SAAS,CAACJ,MAAM,GAAGsB,MAAMlB,SAAS,CAACH,GAAG,EAAE;QAE1D,KAAK;YACH,IAAI,CAACqB,MAAMlB,SAAS,IAAI,CAACkB,MAAMhB,OAAO,EAAE,MAAM,IAAId,MAAM;YACxD,OAAO,GAAG8B,MAAMlB,SAAS,CAACJ,MAAM,GAAGsB,MAAMlB,SAAS,CAACH,GAAG,CAAC,CAAC,EAAEqB,MAAMhB,OAAO,CAACN,MAAM,GAAGsB,MAAMhB,OAAO,CAACL,GAAG,EAAE;QAEtG,KAAK;YACH,IAAI,CAACqB,MAAMf,WAAW,IAAI,CAACe,MAAMd,SAAS,EAAE,MAAM,IAAIhB,MAAM;YAC5D,IAAI8B,MAAMf,WAAW,KAAKe,MAAMd,SAAS,EAAE;gBACzC,OAAOc,MAAMf,WAAW;YAC1B;YACA,OAAO,GAAGe,MAAMf,WAAW,CAAC,CAAC,EAAEe,MAAMd,SAAS,EAAE;QAElD,KAAK;YACH,IAAIc,MAAMX,QAAQ,KAAKY,aAAaD,MAAMV,MAAM,KAAKW,WAAW,MAAM,IAAI/B,MAAM;YAChF,IAAI8B,MAAMX,QAAQ,KAAKW,MAAMV,MAAM,EAAE;gBACnC,OAAOU,MAAMX,QAAQ,CAACa,QAAQ;YAChC;YACA,OAAO,GAAGF,MAAMX,QAAQ,CAAC,CAAC,EAAEW,MAAMV,MAAM,EAAE;QAE5C;YACE,MAAM,IAAIpB,MAAM,CAAC,oBAAoB,EAAE,AAAC8B,MAA4BjB,IAAI,EAAE;IAC9E;AACF;AAEA;;CAEC,GAED;;CAEC,GACD,OAAO,SAASoB,yBAAyBlD,QAAgB;IACvD,MAAM+C,QAAQnB,gBAAgB5B;IAE9B,OAAQ+C,MAAMjB,IAAI;QAChB,KAAK;YACH,OAAO;gBAAEqB,MAAM;gBAAGC,SAAS;gBAAGC,OAAO;YAAE;QAEzC,KAAK;YAAS;gBACZ,IAAI,CAACN,MAAMlB,SAAS,IAAI,CAACkB,MAAMhB,OAAO,EAAE,MAAM,IAAId,MAAM;gBACxD,MAAMkC,OAAOJ,MAAMhB,OAAO,CAACL,GAAG,GAAGqB,MAAMlB,SAAS,CAACH,GAAG,GAAG;gBACvD,MAAM0B,UAAUL,MAAMhB,OAAO,CAACJ,WAAW,GAAGoB,MAAMlB,SAAS,CAACF,WAAW,GAAG;gBAC1E,OAAO;oBAAEwB;oBAAMC;oBAASC,OAAOF,OAAOC;gBAAQ;YAChD;QAEA,KAAK;YAAU;gBACb,IAAIL,MAAMb,gBAAgB,KAAKc,aAAaD,MAAMZ,cAAc,KAAKa,WAAW;oBAC9E,MAAM,IAAI/B,MAAM;gBAClB;gBACA,MAAMqC,cAAcP,MAAMZ,cAAc,GAAGY,MAAMb,gBAAgB,GAAG;gBACpE,OAAO;oBACLiB,MAAM1D,qBAAqBC,QAAQ;oBACnC0D,SAASE;oBACTD,OAAO5D,qBAAqBC,QAAQ,GAAG4D;gBACzC;YACF;QAEA,KAAK;YAAO;gBACV,IAAIP,MAAMX,QAAQ,KAAKY,aAAaD,MAAMV,MAAM,KAAKW,WAAW;oBAC9D,MAAM,IAAI/B,MAAM;gBAClB;gBACA,MAAMsC,WAAWR,MAAMV,MAAM,GAAGU,MAAMX,QAAQ,GAAG;gBACjD,OAAO;oBACLe,MAAMI;oBACNH,SAAS3D,qBAAqBE,WAAW;oBACzC0D,OAAOE,WAAW9D,qBAAqBE,WAAW;gBACpD;YACF;QAEA;YACE,MAAM,IAAIsB,MAAM,CAAC,oBAAoB,EAAE,AAAC8B,MAA2BjB,IAAI,EAAE;IAC7E;AACF;AAEA;;CAEC,GACD,OAAO,SAAS0B,8BAA8BxD,QAAgB;IAC5D,MAAM+C,QAAQnB,gBAAgB5B;IAC9B,IAAI+C,MAAMjB,IAAI,KAAK,UAAUiB,MAAMjB,IAAI,KAAK,SAAS;QACnD,MAAM,IAAIb,MAAM,CAAC,uDAAuD,EAAEjB,UAAU;IACtF;IACA,MAAMyD,aAAaP,yBAAyBlD;IAC5C,IAAIyD,WAAWN,IAAI,GAAG,KAAKM,WAAWL,OAAO,GAAG,GAAG,MAAM,IAAInC,MAAM,CAAC,sCAAsC,EAAEjB,UAAU;IACtH,OAAOyD,WAAWJ,KAAK;AACzB;AAEA,OAAO,SAASK,oBAAoBC,MAAgB;IAClD,OAAOA,OAAOC,MAAM,CAAC,CAACC,OAAOd;QAC3B,MAAMU,aAAaP,yBAAyBH;QAC5C,OAAOc,QAAQJ,WAAWJ,KAAK;IACjC,GAAG;AACL;AAEA;;CAEC,GAED;;CAEC,GACD,OAAO,SAASS,8BACdC,QAIE,EACFC,UAAkB,EAClBC,UAKI,CAAC,CAAC;IAEN,4BAA4B;IAC5BF,SAASG,OAAO,CAAC,CAACC,KAAKC;QACrB,IAAI;YACFpD,mBAAmBmD,IAAIpB,KAAK;QAC9B,EAAE,OAAOsB,OAAO;YACd,MAAM,IAAIpD,MAAM,CAAC,yBAAyB,EAAEmD,MAAM,EAAE,EAAEC,OAAO;QAC/D;IACF;IAEA,uCAAuC;IACvC,MAAMC,aAAaZ,oBAAoBK,SAASQ,GAAG,CAAC,CAACC,IAAMA,EAAEzB,KAAK;IAClE,IAAIuB,aAAa7E,qBAAqBG,SAAS,EAAE;QAC/C,MAAM,IAAIqB,MAAM,CAAC,0CAA0C,EAAEqD,WAAW,GAAG,EAAE7E,qBAAqBG,SAAS,EAAE;IAC/G;IAEA,oBAAoB;IACpB,MAAM6E,OAAOV,SAASQ,GAAG,CAAC,CAACJ,MAAS,CAAA;YAClCpB,OAAO,GAAGiB,WAAW,CAAC,EAAEG,IAAIpB,KAAK,EAAE;YACnC2B,QAAQP,IAAIO,MAAM;YAClBC,gBAAgBR,IAAIQ,cAAc,IAAI;QACxC,CAAA;IAEA,OAAO;QACLC,kBAAkBX,QAAQW,gBAAgB,IAAI;QAC9CH;QACAI,yBAAyBZ,QAAQY,uBAAuB,IAAI;QAC5DC,8BAA8Bb,QAAQa,4BAA4B,IAAI;QACtEC,2BAA2Bd,QAAQc,yBAAyB,IAAI;IAClE;AACF;AAEA;;CAEC,GAED;;CAEC,GACD,OAAO,SAASC,cAAcC,MAAc,EAAEC,MAAc;IAC1D,IAAI;QACF,MAAMC,UAAUvD,gBAAgBqD;QAChC,MAAMG,UAAUxD,gBAAgBsD;QAEhC,8EAA8E;QAC9E,MAAMG,cAAcC,uBAAuBH;QAC3C,MAAMI,cAAcD,uBAAuBF;QAE3C,oBAAoB;QACpB,OAAO,CAAEC,CAAAA,YAAYhD,MAAM,GAAGkD,YAAYnD,QAAQ,IAAImD,YAAYlD,MAAM,GAAGgD,YAAYjD,QAAQ,IAAIiD,YAAYG,MAAM,GAAGD,YAAYE,QAAQ,IAAIF,YAAYC,MAAM,GAAGH,YAAYI,QAAQ,AAAD;IAC1L,EAAE,OAAM;QACN,kDAAkD;QAClD,OAAO;IACT;AACF;AAEA;;CAEC,GACD,SAASH,uBAAuBvC,KAAqB;IAMnD,OAAQA,MAAMjB,IAAI;QAChB,KAAK;YACH,IAAI,CAACiB,MAAMlB,SAAS,EAAE,MAAM,IAAIZ,MAAM;YACtC,OAAO;gBACLmB,UAAUW,MAAMlB,SAAS,CAACH,GAAG;gBAC7BW,QAAQU,MAAMlB,SAAS,CAACH,GAAG;gBAC3B+D,UAAU1C,MAAMlB,SAAS,CAACF,WAAW;gBACrC6D,QAAQzC,MAAMlB,SAAS,CAACF,WAAW;YACrC;QAEF,KAAK;YACH,IAAI,CAACoB,MAAMlB,SAAS,IAAI,CAACkB,MAAMhB,OAAO,EAAE,MAAM,IAAId,MAAM;YACxD,OAAO;gBACLmB,UAAUW,MAAMlB,SAAS,CAACH,GAAG;gBAC7BW,QAAQU,MAAMhB,OAAO,CAACL,GAAG;gBACzB+D,UAAU1C,MAAMlB,SAAS,CAACF,WAAW;gBACrC6D,QAAQzC,MAAMhB,OAAO,CAACJ,WAAW;YACnC;QAEF,KAAK;YACH,IAAIoB,MAAMb,gBAAgB,KAAKc,aAAaD,MAAMZ,cAAc,KAAKa,WAAW;gBAC9E,MAAM,IAAI/B,MAAM;YAClB;YACA,OAAO;gBACLmB,UAAU;gBACVC,QAAQ5C,qBAAqBC,QAAQ;gBACrC+F,UAAU1C,MAAMb,gBAAgB;gBAChCsD,QAAQzC,MAAMZ,cAAc;YAC9B;QAEF,KAAK;YACH,IAAIY,MAAMX,QAAQ,KAAKY,aAAaD,MAAMV,MAAM,KAAKW,WAAW;gBAC9D,MAAM,IAAI/B,MAAM;YAClB;YACA,OAAO;gBACLmB,UAAUW,MAAMX,QAAQ;gBACxBC,QAAQU,MAAMV,MAAM;gBACpBoD,UAAU;gBACVD,QAAQ/F,qBAAqBE,WAAW;YAC1C;QAEF;YACE,MAAM,IAAIsB,MAAM,CAAC,oBAAoB,EAAE,AAAC8B,MAA4BjB,IAAI,EAAE;IAC9E;AACF;AAEA;;CAEC,GACD,OAAO,SAAS4D,qBAAqB/B,MAAgB;IACnD,MAAMgC,YAA6B,EAAE;IAErC,IAAK,IAAIzE,IAAI,GAAGA,IAAIyC,OAAOxC,MAAM,EAAED,IAAK;QACtC,IAAK,IAAI0E,IAAI1E,IAAI,GAAG0E,IAAIjC,OAAOxC,MAAM,EAAEyE,IAAK;YAC1C,MAAMX,SAAStB,MAAM,CAACzC,EAAE;YACxB,MAAMgE,SAASvB,MAAM,CAACiC,EAAE;YAExB,IAAI,CAACX,UAAU,CAACC,QAAQ;YAExB,IAAIF,cAAcC,QAAQC,SAAS;gBACjCS,UAAUE,IAAI,CAAC;oBACbZ;oBACAC;oBACAY,cAAc;oBACdC,aAAa,CAAC,OAAO,EAAEd,OAAO,KAAK,EAAEC,OAAO,QAAQ,CAAC;gBACvD;YACF;QACF;IACF;IAEA,OAAOS;AACT;AAEA;;CAEC,GACD,OAAO,SAASK,oBAAoBrC,MAAgB;IAMlD,MAAMsC,SAAmB,EAAE;IAC3B,MAAMC,WAAqB,EAAE;IAC7B,IAAI5B,aAAa;IAEjB,sBAAsB;IACtBX,OAAOO,OAAO,CAAC,CAACnB,OAAOqB;QACrB,IAAI;YACFpD,mBAAmB+B;YACnB,MAAMU,aAAaP,yBAAyBH;YAC5CuB,cAAcb,WAAWJ,KAAK;YAE9B,kEAAkE;YAClE,IAAII,WAAWJ,KAAK,GAAG,SAAW;gBAChC6C,SAASL,IAAI,CAAC,CAAC,MAAM,EAAEzB,QAAQ,EAAE,EAAE,EAAErB,MAAM,UAAU,EAAEU,WAAWJ,KAAK,CAAC8C,cAAc,GAAG,oCAAoC,CAAC;YAChI;QACF,EAAE,OAAO9B,OAAO;YACd4B,OAAOJ,IAAI,CAAC,CAAC,MAAM,EAAEzB,QAAQ,EAAE,EAAE,EAAErB,MAAM,GAAG,EAAEsB,OAAO;QACvD;IACF;IAEA,0BAA0B;IAC1B,IAAIV,OAAOxC,MAAM,GAAG1B,qBAAqBI,kBAAkB,EAAE;QAC3DoG,OAAOJ,IAAI,CAAC,CAAC,iBAAiB,EAAElC,OAAOxC,MAAM,CAAC,GAAG,EAAE1B,qBAAqBI,kBAAkB,EAAE;IAC9F;IAEA,0BAA0B;IAC1B,IAAIyE,aAAa7E,qBAAqBG,SAAS,EAAE;QAC/CqG,OAAOJ,IAAI,CAAC,CAAC,0BAA0B,EAAEvB,WAAW6B,cAAc,GAAG,GAAG,EAAE1G,qBAAqBG,SAAS,CAACuG,cAAc,IAAI;IAC7H;IAEA,sBAAsB;IACtB,MAAMR,YAAYD,qBAAqB/B;IACvCgC,UAAUzB,OAAO,CAAC,CAACkC;QACjBF,SAASL,IAAI,CAACO,SAASL,WAAW;IACpC;IAEA,OAAO;QACLM,OAAOJ,OAAO9E,MAAM,KAAK;QACzB8E;QACAC;QACA5B;IACF;AACF;AAEA;;CAEC,GAED;;CAEC,GACD,OAAO,SAASgC,YAAYtG,QAAgB,EAAEuG,UAAkB,EAAEC,UAAkB;IAClF,MAAMzD,QAAQnB,gBAAgB5B;IAE9B,IAAI+C,MAAMjB,IAAI,KAAK,UAAUiB,MAAMlB,SAAS,EAAE;QAC5C,MAAM4E,YAAYC,KAAKC,GAAG,CAAC5D,MAAMlB,SAAS,CAACH,GAAG,GAAG6E,YAAY9G,qBAAqBC,QAAQ;QAC1F,MAAMkH,YAAYF,KAAKC,GAAG,CAAC5D,MAAMlB,SAAS,CAACF,WAAW,GAAG6E,YAAY/G,qBAAqBE,WAAW;QACrG,MAAMkH,eAAexF,oBAAoBuF;QAEzC,IAAIL,eAAe,KAAKC,eAAe,GAAG;YACxC,OAAOxG;QACT;QAEA,OAAO,GAAG+C,MAAMlB,SAAS,CAACJ,MAAM,GAAGsB,MAAMlB,SAAS,CAACH,GAAG,CAAC,CAAC,EAAEmF,eAAeJ,WAAW;IACtF;IAEA,IAAI1D,MAAMjB,IAAI,KAAK,WAAWiB,MAAMlB,SAAS,IAAIkB,MAAMhB,OAAO,EAAE;QAC9D,MAAM0E,YAAYC,KAAKC,GAAG,CAAC5D,MAAMhB,OAAO,CAACL,GAAG,GAAG6E,YAAY9G,qBAAqBC,QAAQ;QACxF,MAAMkH,YAAYF,KAAKC,GAAG,CAAC5D,MAAMhB,OAAO,CAACJ,WAAW,GAAG6E,YAAY/G,qBAAqBE,WAAW;QACnG,MAAMkH,eAAexF,oBAAoBuF;QAEzC,OAAO,GAAG7D,MAAMlB,SAAS,CAACJ,MAAM,GAAGsB,MAAMlB,SAAS,CAACH,GAAG,CAAC,CAAC,EAAEmF,eAAeJ,WAAW;IACtF;IAEA,0EAA0E;IAC1E,OAAOzG;AACT;AAEA;;CAEC,GACD,OAAO,SAAS8G,qBAAqB9G,QAAgB,EAAE+G,mBAAmB,MAAO;IAC/E,MAAMhE,QAAQnB,gBAAgB5B;IAC9B,MAAMyD,aAAaP,yBAAyBlD;IAE5C,IAAIyD,WAAWJ,KAAK,IAAI0D,kBAAkB;QACxC,OAAO;YAAC/G;SAAS;IACnB;IAEA,MAAMgH,SAAmB,EAAE;IAE3B,IAAIjE,MAAMjB,IAAI,KAAK,WAAWiB,MAAMlB,SAAS,IAAIkB,MAAMhB,OAAO,EAAE;QAC9D,MAAMkF,YAAYlE,MAAMhB,OAAO,CAACL,GAAG,GAAGqB,MAAMlB,SAAS,CAACH,GAAG,GAAG;QAC5D,MAAMwF,YAAYnE,MAAMhB,OAAO,CAACJ,WAAW,GAAGoB,MAAMlB,SAAS,CAACF,WAAW,GAAG;QAE5E,0CAA0C;QAC1C,MAAMwF,cAAcD;QACpB,MAAME,kBAAkBV,KAAKW,KAAK,CAACN,mBAAmBI;QAEtD,IAAIC,mBAAmB,GAAG;YACxB,gBAAgB;YAChB,IAAK,IAAIE,aAAavE,MAAMlB,SAAS,CAACH,GAAG,EAAE4F,cAAcvE,MAAMhB,OAAO,CAACL,GAAG,EAAE4F,cAAcF,gBAAiB;gBACzG,MAAMG,cAAcb,KAAKC,GAAG,CAACW,aAAaF,kBAAkB,GAAGrE,MAAMhB,OAAO,CAACL,GAAG;gBAChF,MAAM8F,aAAa,GAAGzE,MAAMlB,SAAS,CAACJ,MAAM,GAAG6F,WAAW,CAAC,EAAEvE,MAAMhB,OAAO,CAACN,MAAM,GAAG8F,aAAa;gBACjGP,OAAOnB,IAAI,CAAC2B;YACd;QACF,OAAO;YACL,+CAA+C;YAC/C,MAAMC,kBAAkBf,KAAKW,KAAK,CAACN,mBAAmBE;YAEtD,IAAK,IAAIS,aAAa3E,MAAMlB,SAAS,CAACF,WAAW,EAAE+F,cAAc3E,MAAMhB,OAAO,CAACJ,WAAW,EAAE+F,cAAcD,gBAAiB;gBACzH,MAAME,cAAcjB,KAAKC,GAAG,CAACe,aAAaD,kBAAkB,GAAG1E,MAAMhB,OAAO,CAACJ,WAAW;gBACxF,MAAMiG,cAAcvG,oBAAoBqG;gBACxC,MAAMG,YAAYxG,oBAAoBsG;gBACtC,MAAMH,aAAa,GAAGI,cAAc7E,MAAMlB,SAAS,CAACH,GAAG,CAAC,CAAC,EAAEmG,YAAY9E,MAAMhB,OAAO,CAACL,GAAG,EAAE;gBAC1FsF,OAAOnB,IAAI,CAAC2B;YACd;QACF;IACF,OAAO;QACL,wDAAwD;QACxD,sDAAsD;QACtDR,OAAOnB,IAAI,CAAC7F;IACd;IAEA,OAAOgH;AACT;AAEA;;;;;;;;;;CAUC,GACD,OAAO,SAASc,0BACdC,QAAwB,EACxBC,OAAe;IAQf,IAAID,SAASjG,IAAI,KAAK,UAAUiG,SAASjG,IAAI,KAAK,SAAS;QACzD,2DAA2D;QAC3D,IAAI,CAACiG,SAASlG,SAAS,IAAI,CAACkG,SAAShG,OAAO,EAAE;YAC5C,MAAM,IAAId,MAAM,CAAC,QAAQ,EAAE8G,SAASjG,IAAI,CAAC,iCAAiC,CAAC;QAC7E;QAEA,OAAO;YACLkG;YACA,+CAA+C;YAC/CC,eAAeF,SAASlG,SAAS,CAACH,GAAG,GAAG;YACxC,4DAA4D;YAC5DwG,aAAaH,SAAShG,OAAO,CAACL,GAAG;YACjC,2DAA2D;YAC3DQ,kBAAkB6F,SAASlG,SAAS,CAACF,WAAW,GAAG;YACnD,8BAA8B;YAC9BQ,gBAAgB4F,SAAShG,OAAO,CAACJ,WAAW;QAC9C;IACF;IACA,IAAIoG,SAASjG,IAAI,KAAK,OAAO;QAC3B,gFAAgF;QAChF,IAAIiG,SAAS3F,QAAQ,KAAKY,aAAa+E,SAAS1F,MAAM,KAAKW,WAAW;YACpE,MAAM,IAAI/B,MAAM;QAClB;QAEA,OAAO;YACL+G;YACA,+CAA+C;YAC/CC,eAAeF,SAAS3F,QAAQ,GAAG;YACnC,2BAA2B;YAC3B8F,aAAaH,SAAS1F,MAAM;QAE9B;IACF;IACA,IAAI0F,SAASjG,IAAI,KAAK,UAAU;QAC9B,oGAAoG;QACpG,IAAIiG,SAAS7F,gBAAgB,KAAKc,aAAa+E,SAAS5F,cAAc,KAAKa,WAAW;YACpF,MAAM,IAAI/B,MAAM;QAClB;QAEA,OAAO;YACL+G;YACA,0DAA0D;YAC1D,2DAA2D;YAC3D9F,kBAAkB6F,SAAS7F,gBAAgB,GAAG;YAC9C,8BAA8B;YAC9BC,gBAAgB4F,SAAS5F,cAAc;QACzC;IACF;IAEA,MAAM,IAAIlB,MAAM,CAAC,oBAAoB,EAAE,AAAC8G,SAA+BjG,IAAI,EAAE;AAC/E;AAYA;;;CAGC,GACD,OAAO,SAASqG,qBAAqBnI,QAAgB;IACnD,MAAM+C,QAAQnB,gBAAgB5B;IAC9B,IAAI+C,MAAMjB,IAAI,KAAK,UAAUiB,MAAMjB,IAAI,KAAK,SAAS;QACnD,MAAM,IAAIb,MAAM,CAAC,uDAAuD,EAAEjB,UAAU;IACtF;IACAwD,8BAA8BxD;IAC9B,IAAI,CAAC+C,MAAMlB,SAAS,IAAI,CAACkB,MAAMhB,OAAO,EAAE,MAAM,IAAId,MAAM,CAAC,eAAe,EAAEjB,UAAU;IACpF,OAAO;QAAEoC,UAAUW,MAAMlB,SAAS,CAACH,GAAG;QAAEW,QAAQU,MAAMhB,OAAO,CAACL,GAAG;QAAEM,aAAae,MAAMlB,SAAS,CAACF,WAAW;QAAEM,WAAWc,MAAMhB,OAAO,CAACJ,WAAW;IAAC;AACpJ;AAEA;;CAEC,GACD,OAAO,SAASyG,cAAcC,KAAgB;IAC5C,MAAM/F,QAAQ,GAAGjB,oBAAoBgH,MAAMrG,WAAW,IAAIqG,MAAMjG,QAAQ,EAAE;IAC1E,IAAIiG,MAAMjG,QAAQ,KAAKiG,MAAMhG,MAAM,IAAIgG,MAAMrG,WAAW,KAAKqG,MAAMpG,SAAS,EAAE,OAAOK;IACrF,OAAO,GAAGA,MAAM,CAAC,EAAEjB,oBAAoBgH,MAAMpG,SAAS,IAAIoG,MAAMhG,MAAM,EAAE;AAC1E;AAEA;;;;;;CAMC,GACD,OAAO,SAASiG,oBAAoBC,MAAc,EAAEC,WAAmB,EAAEC,WAAmC;IAC1G,MAAMC,MAAMP,qBAAqBI;IACjC,MAAMI,OAAOR,qBAAqBK;IAClC,MAAMI,UAAUF,IAAIrG,MAAM,GAAGqG,IAAItG,QAAQ,GAAG;IAC5C,MAAMyG,aAAaH,IAAIzG,SAAS,GAAGyG,IAAI1G,WAAW,GAAG;IACrD,MAAMmB,OAAOsF,gBAAgB,cAAcI,aAAaD;IACxD,MAAMxF,UAAUqF,gBAAgB,cAAcG,UAAUC;IACxD,MAAMC,WAAWH,KAAKtG,MAAM,GAAGsG,KAAKvG,QAAQ,GAAG;IAC/C,MAAM2G,cAAcJ,KAAK1G,SAAS,GAAG0G,KAAK3G,WAAW,GAAG;IAExD,IAAI8G,aAAa,KAAKC,gBAAgB,GAAG;QACvC,OAAO;YAAE3G,UAAUuG,KAAKvG,QAAQ;YAAEC,QAAQsG,KAAKvG,QAAQ,GAAGe,OAAO;YAAGnB,aAAa2G,KAAK3G,WAAW;YAAEC,WAAW0G,KAAK3G,WAAW,GAAGoB,UAAU;QAAE;IAC/I;IACA,IAAI0F,WAAW3F,SAAS,KAAK4F,cAAc3F,YAAY,GAAG,OAAOuF;IACjE,MAAM,IAAI1H,MACR,CAAC,YAAY,EAAEuH,YAAY,IAAI,EAAEM,SAAS,CAAC,EAAEC,YAAY,YAAY,EAAEN,gBAAgB,cAAc,gBAAgB,GAAG,OAAO,EAAEF,OAAO,IAAI,EAAEpF,KAAK,CAAC,EAAEC,QAAQ,kCAAkC,EAAE/B,oBAAoBsH,KAAK3G,WAAW,IAAI2G,KAAKvG,QAAQ,CAAC,2DAA2D,EAAEe,KAAK,CAAC,EAAEC,QAAQ,CAAC,CAAC;AAE3U"}
1
+ {"version":3,"sources":["/Users/kevin/Dev/open-source/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 * 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 * Counts cells in a finite sheet-local range, rejecting reversed bounds.\n */\nexport function calculateFiniteRangeCellCount(notation: string): number {\n const range = parseA1Notation(notation);\n if (range.type !== 'cell' && range.type !== 'range') {\n throw new Error(`Range must have finite start and end rows and columns: ${notation}`);\n }\n const dimensions = calculateRangeDimensions(notation);\n if (dimensions.rows < 1 || dimensions.columns < 1) throw new Error(`Range end must not precede its start: ${notation}`);\n return dimensions.cells;\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\n/**\n * A finite, sheet-local block of cells with 1-based inclusive bounds.\n */\nexport interface CellBlock {\n startRow: number;\n endRow: number;\n startColumn: number;\n endColumn: number;\n}\n\n/**\n * Parses a finite sheet-local A1 range (cell or range) into 1-based inclusive bounds.\n * Throws for invalid syntax, whole rows/columns and reversed bounds.\n */\nexport function parseFiniteCellBlock(notation: string): CellBlock {\n const range = parseA1Notation(notation);\n if (range.type !== 'cell' && range.type !== 'range') {\n throw new Error(`Range must have finite start and end rows and columns: ${notation}`);\n }\n calculateFiniteRangeCellCount(notation);\n if (!range.startCell || !range.endCell) throw new Error(`Invalid range: ${notation}`);\n return { startRow: range.startCell.row, endRow: range.endCell.row, startColumn: range.startCell.columnIndex, endColumn: range.endCell.columnIndex };\n}\n\n/**\n * Formats a block as A1 notation (a single cell when it spans one cell).\n */\nexport function cellBlockToA1(block: CellBlock): string {\n const start = `${columnIndexToString(block.startColumn)}${block.startRow}`;\n if (block.startRow === block.endRow && block.startColumn === block.endColumn) return start;\n return `${start}:${columnIndexToString(block.endColumn)}${block.endRow}`;\n}\n\n/**\n * Footprint of a copy-paste: the cells written in the destination.\n *\n * - destination is one cell: the (oriented) source size anchored at that cell\n * - destination is a range whose height and width are whole multiples of the oriented source: the destination itself (the source is tiled)\n * - anything else throws\n */\nexport function calculatePasteRange(source: string, destination: string, orientation: 'NORMAL' | 'TRANSPOSE'): CellBlock {\n const src = parseFiniteCellBlock(source);\n const dest = parseFiniteCellBlock(destination);\n const srcRows = src.endRow - src.startRow + 1;\n const srcColumns = src.endColumn - src.startColumn + 1;\n const rows = orientation === 'TRANSPOSE' ? srcColumns : srcRows;\n const columns = orientation === 'TRANSPOSE' ? srcRows : srcColumns;\n const destRows = dest.endRow - dest.startRow + 1;\n const destColumns = dest.endColumn - dest.startColumn + 1;\n\n if (destRows === 1 && destColumns === 1) {\n return { startRow: dest.startRow, endRow: dest.startRow + rows - 1, startColumn: dest.startColumn, endColumn: dest.startColumn + columns - 1 };\n }\n if (destRows % rows === 0 && destColumns % columns === 0) return dest;\n throw new Error(\n `Destination ${destination} is ${destRows}x${destColumns} cells; the ${orientation === 'TRANSPOSE' ? 'transposed ' : ''}source ${source} is ${rows}x${columns}. Use a single anchor cell (e.g., ${columnIndexToString(dest.startColumn)}${dest.startRow}) or a range whose height and width are whole multiples of ${rows}x${columns}.`\n );\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","calculateFiniteRangeCellCount","dimensions","rangeReferenceToGridRange","rangeRef","sheetId","startRowIndex","endRowIndex","parseFiniteCellBlock","cellBlockToA1","block","calculatePasteRange","source","destination","orientation","src","dest","srcRows","srcColumns","destRows","destColumns"],"mappings":"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"}
@@ -6,31 +6,18 @@ import type { Logger } from '../types.js';
6
6
  * and a failed read throws `Failed to read key columns from <range>: <message>` with the original as cause. Errors thrown by onRow are not wrapped.
7
7
  */
8
8
  export declare function scanKeyColumnRows(sheets: sheets_v4.Sheets, spreadsheetId: string, sheetTitle: string, startCol: string, endCol: string, onRow: (cells: string[], rowNumber: number) => void): Promise<void>;
9
- export declare function ensureSheetIfNeeded(sheets: sheets_v4.Sheets, id: string, sheetTitle: string, ensureSheet: boolean, headers: string[] | undefined, logger: Logger): Promise<{
10
- sheetCreated: boolean;
11
- sheetGUID?: string;
12
- headersEnsured?: boolean;
13
- }>;
14
9
  export declare function findSheetByRef(client: sheets_v4.Sheets, spreadsheetId: string, sheetRef: string, logger: Logger): Promise<sheets_v4.Schema$Sheet | null>;
15
- export declare function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: {
10
+ export declare function ensureTabAndHeaders(sheets: sheets_v4.Sheets, { spreadsheetId, sheetTitle, requiredHeader, keyColumns, }: {
16
11
  spreadsheetId: string;
17
12
  sheetTitle: string;
18
13
  requiredHeader?: string[] | null;
19
14
  keyColumns?: string[];
20
- logger: Logger;
21
15
  }): Promise<{
22
16
  header: string[];
23
17
  keySet: Set<string>;
24
- keyColumnsIdx?: number[];
25
- }>;
26
- export declare function ensureTabAndHeaders(sheets: sheets_v4.Sheets, params: {
27
- spreadsheetId: string;
28
- sheetRef: string;
29
- requiredHeader?: string[] | null;
30
- keyColumns?: string[];
31
- logger: Logger;
32
- }): Promise<{
18
+ keyColumnsIdx?: undefined;
19
+ } | {
33
20
  header: string[];
34
21
  keySet: Set<string>;
35
- keyColumnsIdx?: number[];
22
+ keyColumnsIdx: number[];
36
23
  }>;