overpy 9.6.2 → 9.6.4

package/README.md

@@ -596,7 +596,7 @@ Suppresses the specified warnings globally across the program. Warnings must be
 
 ## #!allowMacroRedeclaration
 
-If specified, will replace the existing macro instead of throwing an error. Can be useful for OOP-like projects where the same codebase is used for multiple different gamemodes.
+If specified, allows redefining a `macro`, `#!define` or `enum` member. Can be useful for OOP-like projects where the same codebase is used for multiple different gamemodes.
 
 ## #!debugElementCount
 
@@ -616,7 +616,7 @@ You can check [here](https://github.com/Zezombye/overpy/issues/33) for a list of
 
 The `#!disableOptimizations` directive can be used to disable all optimizations done by the compiler. Should be only used for debugging, if you suspect that OverPy has bugs in its optimizations, or if you want to generate an unoptimized instruction for some reason.
 
-The `#!optimizeForSize` directive prioritizes lowering the number of elements over optimizing the runtime (see [here](https://github.com/Zezombye/overpy/issues/238) for a list of optimizations).
+The `#!optimizeForSize` directive prioritizes lowering the number of elements over optimizing the runtime (see [here](https://github.com/Zezombye/overpy/issues/238) for a list of optimizations). You can use `#!optimizeForSizeAggressive` (applied codebase-wide and MUST be used alongside `#!optimizeForSize`) for even more optimizations if you really need to squeeze every last element, at the cost of readability.
 
 The `#!optimizeStrict` directive disables some optimizations that may cause issues in extreme cases of type conversion. For example:
 
@@ -956,6 +956,8 @@ OverPy will store the array in a string and automatically decompress it, which t
 
 For more control over the compression (eg if you have separate arrays to compress), you can use the `compress` and `decompressNumbers`/`decompressVectors` functions.
 
+You can also use the `#!useVariableForCompressionAlphabet` compiler option to use a global variable `__compressionAlphabet__` instead of a hardcoded string for the alphabet, which will save further elements.
+
 ## splitDictArray/tabular
 
 `splitDictArray` maps an array of dictionaries to variables. For example:

package/overpy.js

@@ -38600,6 +38600,10 @@ ${scriptText}`, {
       setPlayervarInitRuleName(unescapeString(ruleName, true));
       return;
     }
+    if (content2.startsWith("#!optimizeForSizeAggressive")) {
+      setOptimizationForSizeAggressive(true);
+      return;
+    }
     if (content2.startsWith("#!optimizeForSize")) {
       addToken("__enableOptimizeForSize__");
       return;
@@ -38695,6 +38699,10 @@ ${scriptText}`, {
       setRulePrefixTemplateFilestack(_rulePrefixTemplateFilestack);
       return;
     }
+    if (content2.startsWith("#!useVariableForCompressionAlphabet")) {
+      setUseVariableForCompressionAlphabet(true);
+      return;
+    }
     if (content2.startsWith("#!debugElementCount")) {
       setDebugElementCount(true);
       return;
@@ -45143,8 +45151,9 @@ astParsingFunctions.__if__ = function(content) {
       }
     }
   }
+  let isLoneIf = content.parent.childIndex === content.parent.children.length - 1 || content.parent.childIndex < content.parent.children.length - 1 && !["__elif__", "__else__"].includes(content.parent.children[content.parent.childIndex + 1].name);
   if (enableOptimization) {
-    if (content.children.length === 1 && (content.parent.childIndex === content.parent.children.length - 1 || content.parent.children[content.parent.childIndex + 1].name !== "__elif__" && content.parent.children[content.parent.childIndex + 1].name !== "__else__") && ["return", "loop", "__skip__"].includes(content.children[0].name)) {
+    if (content.children.length === 1 && isLoneIf && ["return", "loop", "__skip__"].includes(content.children[0].name)) {
       if (currentRuleHasVariableGoto) {
         content.parent.children.splice(content.parent.childIndex + 1, 0, content.children[0], getAstForUselessInstruction());
       }
@@ -45166,7 +45175,7 @@ astParsingFunctions.__if__ = function(content) {
       makeChildrenUseless(content.children);
     }
   }
-  if (content.parent.childIndex === content.parent.children.length - 1 || content.parent.childIndex < content.parent.children.length - 1 && !["__elif__", "__else__"].includes(content.parent.children[content.parent.childIndex + 1].name)) {
+  if (isLoneIf) {
     var includeEnd = true;
     if (enableOptimization && currentRuleEvent !== "__subroutine__" && content.parent.childIndex === content.parent.children.length - 1) {
       var root = content;
@@ -45182,6 +45191,16 @@ astParsingFunctions.__if__ = function(content) {
         }
       }
     }
+    if (optimizeForSize2 && optimizeForSizeAggressive && (content.args[0].name === "__not__" || content.children.length === 1 && includeEnd && ["__equals__", "__inequals__", "__greaterThan__", "__greaterThanOrEquals__", "__lessThan__", "__lessThanOrEquals__"].includes(content.args[0].name))) {
+      let label = "__label_if_" + getUniqueNumber() + "__";
+      content.parent.children.splice(content.parent.childIndex + 1, 0, ...content.children, new Ast2(label, [], [], "Label"), getAstForUselessInstruction());
+      if (content.args[0].name === "__not__") {
+        content.args[0] = content.args[0].args[0];
+      } else {
+        content.args[0] = astParsingFunctions.__not__(new Ast2("__not__", [content.args[0]]));
+      }
+      return new Ast2("__skipIf__", [content.args[0], new Ast2("__distanceTo__", [new Ast2(label, [], [], "Label")])]);
+    }
     if (includeEnd) {
       content.parent.children.splice(content.parent.childIndex + 1, 0, getAstForEnd());
     }
@@ -45409,6 +45428,14 @@ astParsingFunctions.__negate__ = function(content) {
 };
 
 // src/compiler/functions/__not__.ts
+var inverseComparisonMapping = {
+  "__equals__": "__inequals__",
+  "__inequals__": "__equals__",
+  "__greaterThan__": "__lessThanOrEquals__",
+  "__greaterThanOrEquals__": "__lessThan__",
+  "__lessThan__": "__greaterThanOrEquals__",
+  "__lessThanOrEquals__": "__greaterThan__"
+};
 astParsingFunctions.__not__ = function(content) {
   if (enableOptimization) {
     if (isDefinitelyFalsy(content.args[0])) {
@@ -45426,6 +45453,9 @@ astParsingFunctions.__not__ = function(content) {
     if (content.args[0].name === ".isDead") {
       return new Ast2(".isAlive", [content.args[0].args[0]]);
     }
+    if (content.args[0].name in inverseComparisonMapping) {
+      return new Ast2(inverseComparisonMapping[content.args[0].name], content.args[0].args);
+    }
   }
   return content;
 };
@@ -46845,16 +46875,18 @@ function compressToString(compressionInfo) {
 }
 function getDecompressionAst(compressedString, compressionInfo) {
   let { minDecimalPlace, maxDecimalPlace, offset, arrayType } = compressionInfo;
+  let formulaAlphabet = useVariableForCompressionAlphabet ? "__compressionAlphabet__" : "x.last()";
+  let formulaCompressedArray = useVariableForCompressionAlphabet ? `$compressedString.split(null[0])` : `[e.concat(${escapeString(alphabet2, false)}) for e in $compressedString.split(null[0])]`;
   if (arrayType === "number") {
-    let decompressionFormula = Array(Math.ceil((maxDecimalPlace - minDecimalPlace) / 2)).fill(0).map((x, i) => i).map((x) => `${Math.pow(100, x + minDecimalPlace / 2)}*x.last().strIndex(x[0].charAt(${x}))`).join(" + ");
-    return parseOpyMacro(`[${decompressionFormula} - ${offset} for x in [e.concat(${escapeString(alphabet2, false)}) for e in $compressedString.split(null[0])]]`, ["$compressedString"], [compressedString]);
+    let decompressionFormula = Array(Math.ceil((maxDecimalPlace - minDecimalPlace) / 2)).fill(0).map((x, i) => i).map((x) => `${Math.pow(100, x + minDecimalPlace / 2)}*${formulaAlphabet}.strIndex(x.charAt(${x}))`).join(" + ");
+    return parseOpyMacro(`[${decompressionFormula} - ${offset} for x in ${formulaCompressedArray}]`, ["$compressedString"], [compressedString]);
   } else {
     let decompressionFormulas = Array(3).fill(0).map((_, h) => {
       return Array(Math.ceil((maxDecimalPlace - minDecimalPlace) / 2)).fill(0).map((x, i) => i).map((x) => `
-                    ${Math.pow(100, x + minDecimalPlace / 2)}*x.last().strIndex(x[0].charAt(${x + Math.ceil((maxDecimalPlace - minDecimalPlace) / 2) * h}))
+                    ${Math.pow(100, x + minDecimalPlace / 2)}*${formulaAlphabet}.strIndex(x.charAt(${x + Math.ceil((maxDecimalPlace - minDecimalPlace) / 2) * h}))
                 `).join(" + ");
     });
-    return parseOpyMacro(`[vect(${decompressionFormulas[0]},${decompressionFormulas[2]},${decompressionFormulas[1]}) - vect(1,1,1)*${offset} for x in [e.concat(${escapeString(alphabet2, false)}) for e in $compressedString.split(null[0])]]`, ["$compressedString"], [compressedString]);
+    return parseOpyMacro(`[vect(${decompressionFormulas[0]},${decompressionFormulas[2]},${decompressionFormulas[1]}) - vect(1,1,1)*${offset} for x in ${formulaCompressedArray}]`, ["$compressedString"], [compressedString]);
   }
 }
 astParsingFunctions.compressed = function(content) {
@@ -47983,9 +48015,6 @@ function parseAstRules(rules) {
     }
     rulesResult.push(parseAst(rule));
   }
-  setOptimizationEnabled2(true);
-  setOptimizeStrict2(false);
-  setOptimizationForSize2(false);
   return rulesResult;
 }
 function parseAst(content) {
@@ -59649,7 +59678,10 @@ var valueFuncKw = (
         {
           "name": "condition",
           "description": "The mapping expression that is evaluated for each element of the copied array. Use the current array element value to reference the element of the array currently being considered.",
-          "type": "bool"
+          "type": [
+            "Object",
+            "Array"
+          ]
         }
       ],
       "isConstant": true,
@@ -64618,7 +64650,7 @@ function astRulesToWs(rules) {
     result += "}\n\n";
     incrementNbElements();
     let ruleElements = nbElements - elementsBefore;
-    if (debugElementCount) {
+    if (debugElementCount && ruleElements > 1) {
       let { filePath } = getRuleFilePath(rule.fileStack);
       ruleElementCounts.push({ name: oldRuleName, file: filePath, elements: ruleElements });
       result = "//" + ruleElements + " element" + (ruleElements !== 1 ? "s" : "") + "\n" + result;
@@ -64630,9 +64662,6 @@ function astRulesToWs(rules) {
     ruleElementCounts.sort((a, b) => b.elements - a.elements);
     elementCountSummary = "/* Element count: (total " + nbElements + ")\n\n" + ruleElementCounts.map((r) => ("" + r.elements).padStart(5, " ") + ": rule " + escapeString(r.name, false) + (r.file ? " (" + r.file + ")" : "")).join("\n") + "\n\n*/\n\n";
   }
-  setOptimizationEnabled2(true);
-  setOptimizeStrict2(false);
-  setOptimizationForSize2(false);
   return { compiledRules, elementCountSummary };
 }
 function astRuleConditionToWs(condition) {
@@ -64958,19 +64987,32 @@ function astToWs(content) {
     if (content.args.length === 0) {
       incrementNbElements();
       return tows("__emptyArray__", valueKw);
-    } else if (optimizeForSize2 && content.parent?.name !== "createWorkshopSettingEnum" && content.args.every((x) => x.name === "__customString__" && x.args.length === 1)) {
-      let separator = "\uEC51";
-      let separatorAst = getAstForCustomString(separator);
-      let str = content.args.map((x) => x.args[0].name).join(separator);
-      if (!str.includes("0")) {
-        separator = "0";
-        separatorAst = new Ast2("__firstOf__", [getAstForNull()]);
-      } else if (!str.includes("(1.00, 0.00, 0.00)") && getUtf8Length(str) % (STR_MAX_LENGTH - "{0}".length) + content.args.length * ("(1.00, 0.00, 0.00)".length - "\uEC51".length) <= STR_MAX_LENGTH) {
-        separator = "(1.00, 0.00, 0.00)";
-        separatorAst = new Ast2("__firstOf__", [new Ast2("Vector.LEFT")]);
-      }
-      str = str.replaceAll("\uEC51", separator);
-      return astToWs(new Ast2(".split", [getAstForCustomString(str), separatorAst]));
+    } else if (optimizeForSize2 && optimizeForSizeAggressive && content.parent?.name !== "createWorkshopSettingEnum") {
+      if (content.args.every((x) => x.name === "__customString__" && x.args.length === 1)) {
+        let separator = "\uEC51";
+        let separatorAst = getAstForCustomString(separator);
+        let str = content.args.map((x) => x.args[0].name).join(separator);
+        if (!str.includes("0")) {
+          separator = "0";
+          separatorAst = new Ast2("__firstOf__", [getAstForNull()]);
+        } else if (!str.includes("(1.00, 0.00, 0.00)") && getUtf8Length(str) % (STR_MAX_LENGTH - "{0}".length) + content.args.length * ("(1.00, 0.00, 0.00)".length - "\uEC51".length) <= STR_MAX_LENGTH) {
+          separator = "(1.00, 0.00, 0.00)";
+          separatorAst = new Ast2("__firstOf__", [new Ast2("Vector.LEFT")]);
+        }
+        str = str.replaceAll("\uEC51", separator);
+        return astToWs(new Ast2(".split", [getAstForCustomString(str), separatorAst]));
+      } else if (content.args.length >= 3 && content.args.every((x) => areAstsAlwaysEqual(x, content.args[0]))) {
+        let estimatedElementCount = 1 + (content.args[0].name === "__customString__" ? 4 : content.args[0].args.length);
+        if (estimatedElementCount === 1 && content.args.length >= 11 || estimatedElementCount === 2 && content.args.length >= 5 || estimatedElementCount === 3 && content.args.length >= 4 || estimatedElementCount >= 4) {
+          return astToWs(new Ast2("__mappedArray__", [
+            new Ast2(".split", [
+              getAstForCustomString("0".repeat(content.args.length - 1)),
+              new Ast2("__firstOf__", [getAstForNull()])
+            ]),
+            content.args[0]
+          ]));
+        }
+      }
     }
   } else if (content.name === "chaseAtRate" || content.name === "chaseOverTime") {
     var newName = content.name === "chaseAtRate" ? "AtRate__" : "OverTime__";
@@ -65636,6 +65678,9 @@ async function compile(content, language = "en-US", _rootPath = "", _mainFileNam
   if (replacementForEmptyString === "variable") {
     addVariable("__emptyString__", true, -1, getInternalFileStack(), tokenize("[].charAt(null)")[0].tokens);
   }
+  if (useVariableForCompressionAlphabet) {
+    addVariable("__compressionAlphabet__", true, -1, getInternalFileStack(), tokenize(escapeString(alphabet2, false))[0].tokens);
+  }
   if (translationLanguages2.length > 0) {
     setTranslatedStrings(importFromPoFiles());
   }
@@ -65787,7 +65832,13 @@ function compileRules(astRules) {
   if (DEBUG_MODE) {
     console.log(parsedAstRules);
   }
+  setOptimizationEnabled2(true);
+  setOptimizeStrict2(false);
+  setOptimizationForSize2(false);
   var { compiledRules, elementCountSummary } = astRulesToWs(parsedAstRules);
+  setOptimizationEnabled2(true);
+  setOptimizeStrict2(false);
+  setOptimizationForSize2(false);
   setFileStack(getInternalFileStack());
   var result = elementCountSummary + compiledCustomGameSettings;
   if (!excludeVariablesInCompilation) {
@@ -66616,7 +66667,7 @@ function parseLines(lines) {
             }
           }
           let enumMemberName = childrenLines[k].tokens[0].toString();
-          if (enumMemberName in enumMembers[args[0].name]) {
+          if (enumMemberName in enumMembers[args[0].name] && !allowMacroRedeclaration) {
             error("Duplicate enum member '" + args[0].name + "." + enumMemberName + "''");
           }
           enumMembers[args[0].name][enumMemberName] = enumValue;
@@ -69106,7 +69157,7 @@ Wrapping a string with \`___\` has the same caveats as putting a translated stri
     return: "String"
   },
   "compressed": {
-    "description": "Compresses in-place the specified array of numbers or vectors into a string, then returns the decompressed array. Strings take much fewer elements, so use this function if you are running out of elements.\n\nNote that numbers will get rounded to 3 decimal places, and vectors to 2 decimal places.\n\nThis function is only effective once the array has at least 18 vectors or 26 numbers.\n\nThis function can be more effective than `compress()` and `decompressNumbers()` / `decompressVectors()`, as it can apply optimizations if all numbers have a low amount of significant digits or if they are all positive.",
+    "description": "Compresses in-place the specified array of numbers or vectors into a string, then returns the decompressed array. Strings take much fewer elements, so use this function if you are running out of elements.\n\nNote that numbers will get rounded to 3 decimal places, and vectors to 2 decimal places.\n\nThis function is only effective once the array has at least 5 vectors or 7 numbers (depending on the complexity; use `#!debugElementCount` to compare).\n\nThis function can be more effective than `compress()` and `decompressNumbers()` / `decompressVectors()`, as it can apply optimizations if all numbers have a low amount of significant digits or if they are all positive.",
     "args": [
       {
         "name": "array",
@@ -69635,6 +69686,8 @@ var enableOptimization;
 var setOptimizationEnabled2 = (enabled) => enableOptimization = enabled;
 var optimizeForSize2;
 var setOptimizationForSize2 = (size) => optimizeForSize2 = size;
+var optimizeForSizeAggressive;
+var setOptimizationForSizeAggressive = (aggressive) => optimizeForSizeAggressive = aggressive;
 var optimizeStrict;
 var setOptimizeStrict2 = (strict) => optimizeStrict = strict;
 var macros = [];
@@ -69721,6 +69774,8 @@ var rulePrefixTemplate = "";
 var setRulePrefixTemplate = (template) => rulePrefixTemplate = template;
 var rulePrefixTemplateFilestack = [];
 var setRulePrefixTemplateFilestack = (filestack) => rulePrefixTemplateFilestack = filestack;
+var useVariableForCompressionAlphabet = false;
+var setUseVariableForCompressionAlphabet = (use) => useVariableForCompressionAlphabet = use;
 var decompilerGotos;
 var resetDecompilerGotos = () => decompilerGotos = [];
 var nbTabs;
@@ -69763,6 +69818,7 @@ function resetGlobalVariables(language) {
   compiledCustomGameSettings = "";
   enableOptimization = true;
   optimizeForSize2 = false;
+  optimizeForSizeAggressive = false;
   optimizeStrict = false;
   uniqueNumber = 1;
   globalInitDirectives = [];
@@ -69800,6 +69856,7 @@ function resetGlobalVariables(language) {
   currentRulePrefix = "";
   rulePrefixTemplate = "";
   rulePrefixTemplateFilestack = [];
+  useVariableForCompressionAlphabet = false;
 }
 var operatorPrecedence = {
   "=": 1,
@@ -72079,10 +72136,10 @@ var key;
 // src/data/opy/preprocessing.ts
 var preprocessingDirectives = {
   "allowMacroRedeclaration": {
-    "description": "If enabled, redefining a `macro` or `#!define` will not throw an error but will overwrite the previous definition. Can be useful for OOP-like projects where the same codebase is used for multiple different gamemodes."
+    "description": "If enabled, redefining a `macro`, `#!define` or `enum` member will not throw an error but will overwrite the previous definition. Can be useful for OOP-like projects where the same codebase is used for multiple different gamemodes."
   },
   "define": {
-    "description": '**Warning**: This directive performs a text-based replacement! Use `macro` or `const` instead, unless absolutely necessary.\n\nCreates a macro, like in C/C++. Macros must be defined before any code. Examples:\n\n    #!define currentSectionWalls A\n    #!define GAME_NOT_STARTED 3`\n\nFunction macros are supported as well:\n\n    #!define getFirstAvailableMei() [player for player in getPlayers(Team.2) if not player.isFighting][0]\n    #!define spawnMei(type, location)     getFirstAvailableMei().meiType = type\\\n    wait(0.1)\\\n    getFirstAvailableMei().teleport(location)\\\n    getFirstAvailableMei().isFighting = true\n\nNote the usage of the backslashed lines.\n\nJS scripts can be inserted with the special `__script__` function:\n\n    #!define addFive(x) __script__("addfive.js")\n\nwhere the `addfive.js` script contains `x+5` (no `return`).\n\nArguments of JS scripts are inserted automatically at the beginning (so `addFive(123)` would cause `var x = 123;` to be inserted). The script is then evaluated using `eval()`.\n\nA `vect()` function is also inserted, so that `vect(1,2,3)` returns an object with the correct properties and `toString()` function.\n\nWhen resolving the macro, the indentation on the macro call is prepended to each line of the replacement.\n',
+    "description": '**Warning**: This directive performs a text-based replacement! Use `macro` instead, unless absolutely necessary.\n\nCreates a macro, like in C/C++. Macros must be defined before any code. Examples:\n\n    #!define currentSectionWalls A\n    #!define GAME_NOT_STARTED 3`\n\nFunction macros are supported as well:\n\n    #!define getFirstAvailableMei() [player for player in getPlayers(Team.2) if not player.isFighting][0]\n    #!define spawnMei(type, location)     getFirstAvailableMei().meiType = type\\\n    wait(0.1)\\\n    getFirstAvailableMei().teleport(location)\\\n    getFirstAvailableMei().isFighting = true\n\nNote the usage of the backslashed lines.\n\nJS scripts can be inserted with the special `__script__` function:\n\n    #!define addFive(x) __script__("addfive.js")\n\nwhere the `addfive.js` script contains `x+5` (no `return`).\n\nArguments of JS scripts are inserted automatically at the beginning (so `addFive(123)` would cause `var x = 123;` to be inserted). The script is then evaluated using `eval()`.\n\nA `vect()` function is also inserted, so that `vect(1,2,3)` returns an object with the correct properties and `toString()` function.\n\nWhen resolving the macro, the indentation on the macro call is prepended to each line of the replacement.\n',
     "snippet": "define $0"
   },
   "debugElementCount": {
@@ -72110,13 +72167,16 @@ var preprocessingDirectives = {
     "description": "Add a rule to obtain an unsanitized '<' character which can be used to create <tx> and <fg> tags.\n\n**WARNING**: The inserted rule creates a dummy bot then immediately destroys it. This has the side effect of triggering each-player rules and may break your gamemode (though if properly coded, it shouldn't).\n\nThe `__holygrail__` variable can be used to obtain the raw '<' character, although it is not necessary as OverPy will automatically take care of the conversion, meaning you can put raw texture tags in strings.\n\nFor color, use the <fgRRGGBBAA> tag, where RR/GG/BB are the hex color value, and AA is the hex transparency value (00 = transparent, FF = opaque).\nExample: `print('<fgFF0000FF>Red text</fg>')`.\n\nFor textures, use the <TX> standalone tag, with the texture id as seen in https://workshop.codes/wiki/articles/tx-reference-sheet.\nExample: `print('<TXC0000000002DD21>')` will display the mouse cursor texture.\n\nAdditionally, you can use the `Texture` enum (such as `Texture.MOUSE_CURSOR`), and OverPy will automatically optimize it.\n\nOverPy will also replace `'<tx1234>'` to the correct full texture id, but only if the entire tag is inside a string (`'<tx{}>'.format(id)` will not work, but `'<tx{}>'.format(1234)` will)."
   },
   "disableOptimizations": {
-    "description": "Disables all optimizations done by the compiler for the current block or file, up until the end of the block/file or the next `#!enableOptimizations` directive."
+    "description": "Disables all optimizations done by the compiler for the current block, up until the end of the block or the next `#!enableOptimizations` directive."
   },
   "enableOptimizations": {
     "description": "Re-enables optimizations after a `#!disableOptimizations` directive. If no `#!disableOptimizations` directive was encountered, this directive does nothing."
   },
   "optimizeForSize": {
-    "description": "Prioritizes lowering the number of elements over optimizing the runtime. Effective for the current block or file, up until the end of the block/file or the next `#!disableOptimizeForSize` directive."
+    "description": "Prioritizes lowering the number of elements over optimizing the runtime. Effective for the current block, up until the end of the block or the next `#!disableOptimizeForSize` directive."
+  },
+  "optimizeForSizeAggressive": {
+    "description": "Enables aggressive optimizations for size, which may significantly lower the readability of the code (for now, replacing `if` by `skip if` in some cases and automatically compressing arrays).\n\n**NOTE:** This directive is applied for the whole codebase and MUST be used alongside `#!optimizeForSize` for it to have an effect."
   },
   "disableOptimizeForSize": {
     "description": "Re-enables optimizations after a `#!optimizeForSize` directive. If no `#!optimizeForSize` directive was encountered, this directive does nothing."
@@ -72132,7 +72192,7 @@ Those optimizations (and others) will be disabled so that the behavior of the ga
 
 This directive is added by default upon decompilation. Only remove it if you are sure that your gamemode does not rely on type conversion tricks. It is recommended to use a website such as http://diffchecker.com to compare the differences in the output when enabling/disabling this directive.
 
-This directive is effective for the current block or file, up until the end of the block/file or the next \`#!disableOptimizeStrict\` directive.`
+This directive is effective for the current block, up until the end of the block or the next \`#!disableOptimizeStrict\` directive.`
   },
   "disableOptimizeStrict": {
     "description": "Re-enables optimizations after a `#!optimizeStrict` directive. If no `#!optimizeStrict` directive was encountered, this directive does nothing."
@@ -72262,6 +72322,9 @@ You can specify \`noDetectionRule\` to not create the rule which sets the variab
 You can also specify \`noTlErr\` to have spectators view the default language when viewing a translated string (the \`__languageIndex__\` variable is now 0-indexed instead of 1-indexed). Keep in mind that, if translations aren't used properly, you may not see it if you playtest with the default language.
         `
   },
+  "useVariableForCompressionAlphabet": {
+    "description": `If enabled, the compression functions will use a global variable \`__compressionAlphabet__\` instead of a hardcoded string for the alphabet, which will save further elements.`
+  },
   "extension": {
     "description": "You shouldn't be reading this. Contact Zezombye if you can see this.",
     "snippet": "You shouldn't be reading this. Contact Zezombye if you can see this."

package/package.json

@@ -7,7 +7,7 @@
         "url": "https://github.com/Zezombye/overpy"
     },
     "description": "High-level language for the Overwatch Workshop, with decompilation and compilation.",
-    "version": "9.6.2",
+    "version": "9.6.4",
     "readme": "README.md",
     "keywords": [
         "overpy",