shortcutxl 0.3.44 → 0.3.45

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## [0.3.45]
+
+- **Preserve Excel calculation mode** — ShortcutXL no longer overrides Excel's calculation mode during code execution. If you have manual calculation enabled, it stays manual while Shortcut runs your code.
+
 ## [0.3.44]
 
 - **Shorty mascot** — Replaced the braille X logo with a new Shorty block-art mascot.

package/dist/app/prompts/com-api-reference.json

@@ -6,47 +6,70 @@
         "getSheetNames": {
           "signature": "def getSheetNames() -> list[str]",
           "docstring": "Get the names of all sheets in the workbook.",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "getWorkbookSummary": {
           "signature": "def getWorkbookSummary() -> str",
           "docstring": "Get sheet names and used ranges for this workbook.\nReturns lines like:\n    Sheets and their used ranges:\n      Sheet1: A1:D10 (active)\n      Inputs: (empty)",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "getSheet": {
           "signature": "def getSheet(name: str) -> 'Worksheet'",
           "docstring": "Get a sheet by name, returned as a wrapped Worksheet.",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "addSheet": {
           "signature": "def addSheet(name: str, index: int | None = None) -> 'Worksheet'",
           "docstring": "Add a new sheet at 0-based index. index=0 inserts before the first sheet.\nOmit index for Excel's default position.\nExample: wb.addSheet(\"NewSheet\", 0)  # insert as first sheet",
-          "tags": ["action"]
+          "tags": [
+            "action"
+          ]
         },
         "moveSheet": {
           "signature": "def moveSheet(name: str, index: int) -> None",
           "docstring": "Move a sheet to 0-based index. index=0 moves to first, index=Count-1 moves to last.\nExample: wb.moveSheet(\"Data\", 0)  # move to first position",
-          "tags": ["action"]
+          "tags": [
+            "action"
+          ]
         },
         "calculate": {
           "signature": "def calculate() -> None",
           "docstring": "Recalculate the entire workbook.\nDependent formulas don't update until after code block completes \u2014 read in a follow-up block.",
-          "tags": ["action"]
+          "tags": [
+            "action"
+          ]
         },
         "errorCheck": {
           "signature": "def errorCheck(ranges: list[str] | None = None) -> str",
           "docstring": "Scan for errors (#REF!, #DIV/0!, #NAME?, #VALUE!, #N/A, #NULL!, #NUM!). Ranges MUST include a sheet name (\"Sheet1\" or \"Sheet1!A1:D50\") \u2014 bare ranges like \"A1:D50\" will fail.\n      Args:\n          ranges: Optional sheet names (\"Sheet1\") or ranges (\"Sheet1!A1:D50\"). Omit to check all.\n      Returns:\n          \"No issues found.\" or \"Errors (N):\nSheet1!A1: #REF!\n...\"",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "copyPasteRange": {
           "signature": "def copyPasteRange(from_range: str, to_address: str, paste_type: str = 'all', ) -> None",
           "docstring": "Copy range within same workbook via range.Copy + PasteSpecial.\nAddresses must include sheet name. Do NOT use Sheet.Copy (broken via pywin32).\nExample: wb.copyPasteRange(\"Sheet1!A1:D10\", \"Sheet2!A1\", paste_type=\"values\")",
-          "tags": ["action"]
+          "tags": [
+            "action"
+          ]
         },
         "getNamedRangeInfo": {
           "signature": "def getNamedRangeInfo(max_count: int = 50) -> str",
           "docstring": "Get named ranges. Returns formatted string with name, reference, scope, and comment.\nExample output: \"Named Ranges (2):\\n  Name: TaxRate | Ref: =Settings!$B$2 | Scope: workbook | Comment: ...\"\nReturns \"No named ranges found.\" if none exist.",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         }
       }
     },
@@ -56,62 +79,93 @@
         "getSheetSummary": {
           "signature": "def getSheetSummary() -> str",
           "docstring": "Overview: name, used range, tables (with style/banded/header/total props),\npivots (with range), conditional formats (type/range/priority/stopIfTrue),\nautofilter (with filtering status), charts (with type).",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "getUsedRange": {
           "signature": "def getUsedRange() -> str",
           "docstring": "Get the used range address like \"A1:F20\", or \"\" if empty.",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "getCell": {
           "signature": "def getCell(address: str, include_style: bool = True) -> str",
           "docstring": "Formatted cell string: \"value(=FORMULA) (style_json)\". Formula always included.\nZero with custom format appends [0]: \"$ - [0]\".\nExample:\n    print(sheet.getCell(\"A1\"))\n    print(sheet.getCell(\"A1\", include_style=False))",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "getCellRange": {
           "signature": "def getCellRange(range_addr: str, include_style: bool = True) -> str",
           "docstring": "Markdown-like range: \"A1:Name | B1:Value\\nA2:Alice | B2:100\". Uses display text. Max 3000 cells; read larger areas in smaller chunks.\nAppends \"--- Style patterns ---\" section when include_style=True.",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "getRawCellData": {
           "signature": "def getRawCellData(address: str, formula: bool = False) -> Any",
           "docstring": "Get raw data value from a cell, preserving data type. Set formula=True to get the formula string.",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "getRawRangeData": {
           "signature": "def getRawRangeData(range_addr: str, formula: bool = False) -> list[list[Any]]",
           "docstring": "Get raw data for a range as 2D list. Always returns 2D list even for single row/column.",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "regexSearch": {
           "signature": "def regexSearch(patterns: list[str], match_case: bool = False) -> list[dict]",
           "docstring": "Regex search across used range using display text. Returns [{\"address\": \"A1\", \"value\": \"display text\"}, ...].\nExample: sheet.regexSearch([\"revenue\", \"cost\"])",
-          "tags": ["action", "ask"]
+          "tags": [
+            "action",
+            "ask"
+          ]
         },
         "setCell": {
           "signature": "def setCell(address: str, value: Any, number_format: str | None = None, note: str | None = None, ) -> None",
           "docstring": "Write value or formula. \"=\" prefix = formula. None or \"\" clears the cell.\nExamples:\n    sheet.setCell(\"A1\", 8000)\n    sheet.setCell(\"C1\", 0.15, number_format=\"0%\", note=\"Tax rate\")\n    sheet.setCell(\"B1\", \"=SUM(A1:A10)\")",
-          "tags": ["action"]
+          "tags": [
+            "action"
+          ]
         },
         "setCellRange": {
           "signature": "def setCellRange(range_addr: str, values: list[list[Any]], number_format: str | None = None, ) -> None",
           "docstring": "Bulk write \u2014 ALWAYS use for >100 cells. \"=\" prefix = formula.\nExamples:\n    sheet.setCellRange(\"A1:B2\", [[1, 2], [3, 4]])\n    sheet.setCellRange(\"A1:B2\", [[\"=SUM(C1)\", \"=SUM(D1)\"], [5, 6]], number_format=\"$#,##0\")",
-          "tags": ["action"]
+          "tags": [
+            "action"
+          ]
         },
         "autoFill": {
           "signature": "def autoFill(source_range: str, target_range: str, fill_mode: str = 'auto', ) -> None",
           "docstring": "Drag-fill. Source must be contained within target. Default \"auto\" increments hardcoded numeric literals; use fill_mode=\"constant\" to copy literal values, then read back destination cells and check for empty/NaN values.\nUse fill_mode=\"constant\" when copying a single value without incrementing.\nWARNING: Single numeric value with \"auto\" creates incrementing sequence (0,1,2,3...).\nExample: sheet.autoFill(\"A1:A2\", \"A1:A10\")",
-          "tags": ["action"]
+          "tags": [
+            "action"
+          ]
         },
         "addPicture": {
           "signature": "def addPicture(name: str, base64_data: str, anchor_cell: str) -> None",
           "docstring": "Add a picture from base64-encoded PNG or JPEG data. No data URI prefix.\nExample: sheet.addPicture(\"chart1\", base64_string, \"F2\")",
-          "tags": ["action"]
+          "tags": [
+            "action"
+          ]
         },
         "setIBTextColors": {
           "signature": "def setIBTextColors(range_addr: str, ignored_constants: list[int] | None = None, colors: dict | None = None, ) -> None",
           "docstring": "IB text colors for numeric inputs only. Text strings and booleans are left untouched.\n- Blue/16711680: hard-coded numeric constants (int/float)\n- Black/0: formulas (same-sheet references)\n- Green/32768: formulas with cross-sheet references (contains '!')\nColors are BGR integers (native COM format).\nExample: sheet.setIBTextColors(\"A1:D10\", ignored_constants=[0])",
-          "tags": ["action"]
+          "tags": [
+            "action"
+          ]
         }
       }
     }
@@ -120,27 +174,42 @@
     "hex_to_bgr": {
       "signature": "def hex_to_bgr(hex_str: str) -> int",
       "docstring": "Convert \"#RRGGBB\" hex string to BGR integer for Excel COM.\nExample: ws.Range(\"A1\").Font.Color = hex_to_bgr(\"#FF0000\")  # red",
-      "tags": ["action", "ask"]
+      "tags": [
+        "action",
+        "ask"
+      ]
     },
     "index_to_address": {
       "signature": "def index_to_address(row: int, col: int) -> str",
       "docstring": "Convert 0-based (row, col) to Excel address: index_to_address(0, 0) \u2192 \"A1\".",
-      "tags": ["action", "ask"]
+      "tags": [
+        "action",
+        "ask"
+      ]
     },
     "address_to_index": {
       "signature": "def address_to_index(address: str) -> tuple[int, int]",
       "docstring": "Parse \"A1\" into (row, col) 0-based tuple: address_to_index(\"B3\") \u2192 (2, 1).",
-      "tags": ["action", "ask"]
+      "tags": [
+        "action",
+        "ask"
+      ]
     },
     "col_letter": {
       "signature": "def col_letter(index: int) -> str",
       "docstring": "Convert 0-based column index to letter: col_letter(26) \u2192 \"AA\".",
-      "tags": ["action", "ask"]
+      "tags": [
+        "action",
+        "ask"
+      ]
     },
     "col_index": {
       "signature": "def col_index(letter: str) -> int",
       "docstring": "Convert column letter to 0-based index: col_index(\"AA\") \u2192 26.",
-      "tags": ["action", "ask"]
+      "tags": [
+        "action",
+        "ask"
+      ]
     }
   }
 }