mana-scribe 2.1.1 → 2.2.0

package/LICENSE

@@ -1,7 +1,7 @@
-Copyright 2025 Colin A
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+Copyright 2025 Colin A
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,120 +1,120 @@
-# mana-scribe
-[![Tests](https://github.com/matortheeternal/mana-scribe/actions/workflows/tests.yml/badge.svg)](https://github.com/matortheeternal/mana-scribe/actions/workflows/tests.yml) [![codecov](https://codecov.io/github/matortheeternal/mana-scribe/graph/badge.svg?token=Z81O4KMEOH)](https://codecov.io/github/matortheeternal/mana-scribe)
-
-Mana Scribe is a utility for working with Magic: The Gathering mana costs and activation costs.
-
-Supports both brace `{3}{R/U}` and shortform `3R/U` notation.
-
-## Features
-
-- Parse MTG mana costs into structured objects
-- Supports all major symbols: generic, colored, 2-5 color hybrid, phyrexian, generic hybrid, phyrexian hybrid, snow, energy, tap/untap, variable
-- Works with both Scryfall braces and shortform notation
-- Compute:
-  - Converted mana cost
-  - Color identity
-  - Devotion
-- Compare mana costs (equality, greater than, less than)
-- Easily add custom colors, types of mana, or other extra symbols
-
-Note: When the parser encounters an unrecognized symbol it stops parsing and returns the symbols it parsed so far.  You can access the unparsed string component through the property `remainingStr`.
-
-## Installation
-
-```bash
-npm install mana-scribe
-```
-
-## Usage
-```js
-import { ManaCost } from 'mana-scribe';
-
-const cost = ManaCost.parse('{3}{R}{R}{R}');
-console.log(cost.cmc);                // 6
-console.log(cost.colors);             // ['R']
-console.log(cost.getDevotionTo('R')); // 3
-
-console.log(cost.toString(true));     // "{3}{R}{R}{R}"
-console.log(cost.toString(false));    // "3RRR"
-```
-### Shortform example
-```js
-const cost = ManaCost.parse('2WU/B');
-console.log(cost.cmc);     // 4
-console.log(cost.colors);  // ['W','U','B']
-```
-
-### Comparison example
-The `ManaCost` class supports equality and comparison operators under superset semantics:
-
-- `equals(other)` → true if the costs are exactly the same
-- `greaterThan(other)` → true if this cost includes all symbols of other plus additional ones, or generic mana cost is higher.
-- `lessThan(other)` → true if this cost is a strict subset of other, or generic mana cost is lower.
-
-```js
-const a = ManaCost.parse('{3}{B}{B}{B}');
-const b = ManaCost.parse('{1}{B}{B}{B}');
-
-console.log(a.equals(b));       // false
-console.log(a.greaterThan(b));  // true
-console.log(b.lessThan(a));     // true
-```
-
-
-### Activation costs
-`ActivationCost` offers the same functionality as the `ManaCost` class, but supports additional symbols such as Tap, Untap, and Energy.  It does not have comparison functions.
-
-```js
-import { ActivationCost } from 'mana-scribe';
-
-const cost = ActivationCost.parse('{1}{G}{T}');
-console.log(cost.symbols.map(s => s.type)); // ["genericMana", "coloredMana", "tap"]
-console.log(cost.toString(true));           // "{1}{G}{T}"
-```
-
-## Extending
-
-### Custom colors
-
-You can add custom colors of mana with `symbolRegistry.addColor`.
-
-```js
-import { symbolRegistry, ManaCost } from 'mana-scribe';
-
-symbolRegistry.addColor({ id: 'P', name: 'Purple' });
-const cost = ManaCost.parse('{3}{R/P}{P}');
-console.log(cost.symbols.map(s => s.type)); // ["genericMana", "twoColorHybridMana", "coloredMana"]
-console.log(cost.cmc); // 5
-console.log(cost.colors);  // ['R','P']
-console.log(cost.getDevotionTo('P')); // 2
-```
-
-### Custom mana types
-
-You can add custom types of mana with `symbolRegistry.addManaType`. This is for mana produced by specific sources, like snow mana.
-
-```js
-import { symbolRegistry, ActivationCost } from 'mana-scribe';
-
-symbolRegistry.addManaType({ id: 'A', name: 'Artificial' }); // mana produced by an artifact
-const cost = ActivationCost.parse('{A}{A}{T}');
-console.log(cost.symbols.map(s => s.type)); // ["typedMana", "typedMana", "tap"]
-console.log(cost.colors);  // []
-```
-
-### Extra symbols
-
-You can add additional symbols for use in activation costs with `symbolRegistry.addExtraSym`. This is used for things like the energy symbol.
-
-```js
-import { symbolRegistry, ActivationCost } from 'mana-scribe';
-
-symbolRegistry.addManaType({ id: '\\@', name: 'Chaos' });
-const cost = ActivationCost.parse('{@}');
-console.log(cost.symbols.map(s => s.type)); // ["extra"]
-console.log(cost.colors);  // []
-```
-
-## License
-
-This project is licensed under the MIT License.  See LICENSE for more info.
+# mana-scribe
+[![Tests](https://github.com/matortheeternal/mana-scribe/actions/workflows/tests.yml/badge.svg)](https://github.com/matortheeternal/mana-scribe/actions/workflows/tests.yml) [![codecov](https://codecov.io/github/matortheeternal/mana-scribe/graph/badge.svg?token=Z81O4KMEOH)](https://codecov.io/github/matortheeternal/mana-scribe)
+
+Mana Scribe is a utility for working with Magic: The Gathering mana costs and activation costs.
+
+Supports both brace `{3}{R/U}` and shortform `3R/U` notation.
+
+## Features
+
+- Parse MTG mana costs into structured objects
+- Supports all major symbols: generic, colored, 2-5 color hybrid, phyrexian, generic hybrid, phyrexian hybrid, snow, energy, tap/untap, variable
+- Works with both Scryfall braces and shortform notation
+- Compute:
+  - Converted mana cost
+  - Color identity
+  - Devotion
+- Compare mana costs (equality, greater than, less than)
+- Easily add custom colors, types of mana, or other extra symbols
+
+Note: When the parser encounters an unrecognized symbol it stops parsing and returns the symbols it parsed so far.  You can access the unparsed string component through the property `remainingStr`.
+
+## Installation
+
+```bash
+npm install mana-scribe
+```
+
+## Usage
+```js
+import { ManaCost } from 'mana-scribe';
+
+const cost = ManaCost.parse('{3}{R}{R}{R}');
+console.log(cost.cmc);                // 6
+console.log(cost.colors);             // ['R']
+console.log(cost.getDevotionTo('R')); // 3
+
+console.log(cost.toString(true));     // "{3}{R}{R}{R}"
+console.log(cost.toString(false));    // "3RRR"
+```
+### Shortform example
+```js
+const cost = ManaCost.parse('2WU/B');
+console.log(cost.cmc);     // 4
+console.log(cost.colors);  // ['W','U','B']
+```
+
+### Comparison example
+The `ManaCost` class supports equality and comparison operators under superset semantics:
+
+- `equals(other)` → true if the costs are exactly the same
+- `greaterThan(other)` → true if this cost includes all symbols of other plus additional ones, or generic mana cost is higher.
+- `lessThan(other)` → true if this cost is a strict subset of other, or generic mana cost is lower.
+
+```js
+const a = ManaCost.parse('{3}{B}{B}{B}');
+const b = ManaCost.parse('{1}{B}{B}{B}');
+
+console.log(a.equals(b));       // false
+console.log(a.greaterThan(b));  // true
+console.log(b.lessThan(a));     // true
+```
+
+
+### Activation costs
+`ActivationCost` offers the same functionality as the `ManaCost` class, but supports additional symbols such as Tap, Untap, and Energy.  It does not have comparison functions.
+
+```js
+import { ActivationCost } from 'mana-scribe';
+
+const cost = ActivationCost.parse('{1}{G}{T}');
+console.log(cost.symbols.map(s => s.type)); // ["genericMana", "coloredMana", "tap"]
+console.log(cost.toString(true));           // "{1}{G}{T}"
+```
+
+## Extending
+
+### Custom colors
+
+You can add custom colors of mana with `symbolRegistry.addColor`.
+
+```js
+import { symbolRegistry, ManaCost } from 'mana-scribe';
+
+symbolRegistry.addColor({ id: 'P', name: 'Purple' });
+const cost = ManaCost.parse('{3}{R/P}{P}');
+console.log(cost.symbols.map(s => s.type)); // ["genericMana", "twoColorHybridMana", "coloredMana"]
+console.log(cost.cmc); // 5
+console.log(cost.colors);  // ['R','P']
+console.log(cost.getDevotionTo('P')); // 2
+```
+
+### Custom mana types
+
+You can add custom types of mana with `symbolRegistry.addManaType`. This is for mana produced by specific sources, like snow mana.
+
+```js
+import { symbolRegistry, ActivationCost } from 'mana-scribe';
+
+symbolRegistry.addManaType({ id: 'A', name: 'Artificial' }); // mana produced by an artifact
+const cost = ActivationCost.parse('{A}{A}{T}');
+console.log(cost.symbols.map(s => s.type)); // ["typedMana", "typedMana", "tap"]
+console.log(cost.colors);  // []
+```
+
+### Extra symbols
+
+You can add additional symbols for use in activation costs with `symbolRegistry.addExtraSym`. This is used for things like the energy symbol.
+
+```js
+import { symbolRegistry, ActivationCost } from 'mana-scribe';
+
+symbolRegistry.addManaType({ id: '\\@', name: 'Chaos' });
+const cost = ActivationCost.parse('{@}');
+console.log(cost.symbols.map(s => s.type)); // ["extra"]
+console.log(cost.colors);  // []
+```
+
+## License
+
+This project is licensed under the MIT License.  See LICENSE for more info.

package/package.json

@@ -1,41 +1,41 @@
-{
-  "name": "mana-scribe",
-  "version": "2.1.1",
-  "description": "Library for parsing and querying Magic: The Gathering mana costs — with support for CMC, devotion, and color identity.",
-  "keywords": [
-    "mtg",
-    "magic the gathering",
-    "mana",
-    "cost",
-    "parser"
-  ],
-  "bugs": {
-    "url": "https://github.com/matortheeternal/mana-scribe/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/matortheeternal/mana-scribe.git"
-  },
-  "license": "MIT",
-  "author": "mator",
-  "type": "module",
-  "main": "./src/index.js",
-  "exports": {
-    ".": "./src/index.js"
-  },
-  "devDependencies": {
-    "c8": "^10.1.3",
-    "jasmine": "^5.12.0"
-  },
-  "scripts": {
-    "test": "jasmine --config=jasmine.json",
-    "debug:test": "node --inspect-brk node_modules/jasmine/bin/jasmine.js --config=jasmine.json",
-    "coverage": "c8 npm test"
-  },
-  "files": [
-    "src/",
-    "README.md",
-    "LICENSE",
-    "package.json"
-  ]
-}
+{
+  "name": "mana-scribe",
+  "version": "2.2.0",
+  "description": "Library for parsing and querying Magic: The Gathering mana costs — with support for CMC, devotion, and color identity.",
+  "keywords": [
+    "mtg",
+    "magic the gathering",
+    "mana",
+    "cost",
+    "parser"
+  ],
+  "bugs": {
+    "url": "https://github.com/matortheeternal/mana-scribe/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/matortheeternal/mana-scribe.git"
+  },
+  "license": "MIT",
+  "author": "mator",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "devDependencies": {
+    "c8": "^10.1.3",
+    "jasmine": "^5.12.0"
+  },
+  "scripts": {
+    "test": "jasmine --config=jasmine.json",
+    "debug:test": "node --inspect-brk node_modules/jasmine/bin/jasmine.js --config=jasmine.json",
+    "coverage": "c8 npm test"
+  },
+  "files": [
+    "src/",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ]
+}

package/src/arrayComparison.js

@@ -1,50 +1,50 @@
-function toFrequencyMap(arr) {
-    const map = new Map();
-    for (const el of arr) {
-        if (el.type === 'genericMana' || el.type === 'infiniteMana') {
-            map.set('generic', (map.get('generic') || 0) + el.cmcValue());
-        } else {
-            const key = el.toString();
-            map.set(key, (map.get(key) || 0) + 1);
-        }
-    }
-    return map;
-}
-
-export function arrayEquals(arr1, arr2) {
-    const m1 = toFrequencyMap(arr1);
-    const m2 = toFrequencyMap(arr2);
-
-    if (m1.size !== m2.size) return false;
-    for (const [key, count] of m1.entries()) {
-        if ((m2.get(key) || 0) !== count) return false;
-    }
-    return true;
-}
-
-export function arrayGreaterThan(arr1, arr2) {
-    const m1 = toFrequencyMap(arr1);
-    const m2 = toFrequencyMap(arr2);
-
-    let larger = false;
-    for (const [key, count] of m2.entries()) {
-        if ((m1.get(key) || 0) < count) return false;
-        larger = larger || m1.get(key) > count;
-    }
-
-    return larger || m1.size > m2.size;
-}
-
-export function arrayLessThan(arr1, arr2) {
-    const m1 = toFrequencyMap(arr1);
-    const m2 = toFrequencyMap(arr2);
-
-    let smaller = false;
-    for (const [key, count] of m1.entries()) {
-        if ((m2.get(key) || 0) < count) return false;
-        smaller = smaller || (count < (m2.get(key) || 0));
-    }
-
-    return smaller || m1.size < m2.size;
-}
-
+function toFrequencyMap(arr) {
+    const map = new Map();
+    for (const el of arr) {
+        if (el.type === 'genericMana' || el.type === 'infiniteMana') {
+            map.set('generic', (map.get('generic') || 0) + el.cmcValue());
+        } else {
+            const key = el.toString();
+            map.set(key, (map.get(key) || 0) + 1);
+        }
+    }
+    return map;
+}
+
+export function arrayEquals(arr1, arr2) {
+    const m1 = toFrequencyMap(arr1);
+    const m2 = toFrequencyMap(arr2);
+
+    if (m1.size !== m2.size) return false;
+    for (const [key, count] of m1.entries()) {
+        if ((m2.get(key) || 0) !== count) return false;
+    }
+    return true;
+}
+
+export function arrayGreaterThan(arr1, arr2) {
+    const m1 = toFrequencyMap(arr1);
+    const m2 = toFrequencyMap(arr2);
+
+    let larger = false;
+    for (const [key, count] of m2.entries()) {
+        if ((m1.get(key) || 0) < count) return false;
+        larger = larger || m1.get(key) > count;
+    }
+
+    return larger || m1.size > m2.size;
+}
+
+export function arrayLessThan(arr1, arr2) {
+    const m1 = toFrequencyMap(arr1);
+    const m2 = toFrequencyMap(arr2);
+
+    let smaller = false;
+    for (const [key, count] of m1.entries()) {
+        if ((m2.get(key) || 0) < count) return false;
+        smaller = smaller || (count < (m2.get(key) || 0));
+    }
+
+    return smaller || m1.size < m2.size;
+}
+

package/src/costs/ActivationCost.js

@@ -1,33 +1,33 @@
-import Cost from './Cost.js';
-import ColoredManaSymbol from '../symbols/ColoredManaSymbol.js';
-import ColoredPhyrexianManaSymbol from '../symbols/ColoredPhyrexianManaSymbol.js';
-import ColorlessManaSymbol from '../symbols/ColorlessManaSymbol.js';
-import ColorlessPhyrexianManaSymbol from '../symbols/ColorlessPhyrexianManaSymbol.js';
-import ExtraSymbol from '../symbols/ExtraSymbol.js';
-import FiveColorHybridManaSymbol from '../symbols/FiveColorHybridManaSymbol.js';
-import FourColorHybridManaSymbol from '../symbols/FourColorHybridManaSymbol.js';
-import GenericHybridManaSymbol from '../symbols/GenericHybridManaSymbol.js';
-import GenericManaSymbol from '../symbols/GenericManaSymbol.js';
-import HalfManaSymbol from '../symbols/HalfManaSymbol.js';
-import HybridPhyrexianManaSymbol from '../symbols/HybridPhyrexianManaSymbol.js';
-import InfiniteManaSymbol from '../symbols/InfiniteManaSymbol.js';
-import TypedManaSymbol from '../symbols/TypedManaSymbol.js';
-import TapSymbol from '../symbols/TapSymbol.js';
-import ThreeColorHybridManaSymbol from '../symbols/ThreeColorHybridManaSymbol.js';
-import TwoColorHybridManaSymbol from '../symbols/TwoColorHybridManaSymbol.js';
-import UntapSymbol from '../symbols/UntapSymbol.js';
-import VariableManaSymbol from '../symbols/VariableManaSymbol.js';
-
-export default class ActivationCost extends Cost {
-    static get allowedSymbols() {
-        return [
-            HybridPhyrexianManaSymbol, ColoredPhyrexianManaSymbol,
-            GenericHybridManaSymbol, FiveColorHybridManaSymbol,
-            FourColorHybridManaSymbol, ThreeColorHybridManaSymbol,
-            TwoColorHybridManaSymbol, HalfManaSymbol, ColorlessPhyrexianManaSymbol,
-            GenericManaSymbol, VariableManaSymbol, InfiniteManaSymbol,
-            TypedManaSymbol, ColoredManaSymbol, ColorlessManaSymbol,
-            ExtraSymbol, TapSymbol, UntapSymbol,
-        ];
-    }
-}
+import Cost from './Cost.js';
+import ColoredManaSymbol from '../symbols/ColoredManaSymbol.js';
+import ColoredPhyrexianManaSymbol from '../symbols/ColoredPhyrexianManaSymbol.js';
+import ColorlessManaSymbol from '../symbols/ColorlessManaSymbol.js';
+import ColorlessPhyrexianManaSymbol from '../symbols/ColorlessPhyrexianManaSymbol.js';
+import ExtraSymbol from '../symbols/ExtraSymbol.js';
+import FiveColorHybridManaSymbol from '../symbols/FiveColorHybridManaSymbol.js';
+import FourColorHybridManaSymbol from '../symbols/FourColorHybridManaSymbol.js';
+import GenericHybridManaSymbol from '../symbols/GenericHybridManaSymbol.js';
+import GenericManaSymbol from '../symbols/GenericManaSymbol.js';
+import HalfManaSymbol from '../symbols/HalfManaSymbol.js';
+import HybridPhyrexianManaSymbol from '../symbols/HybridPhyrexianManaSymbol.js';
+import InfiniteManaSymbol from '../symbols/InfiniteManaSymbol.js';
+import TypedManaSymbol from '../symbols/TypedManaSymbol.js';
+import TapSymbol from '../symbols/TapSymbol.js';
+import ThreeColorHybridManaSymbol from '../symbols/ThreeColorHybridManaSymbol.js';
+import TwoColorHybridManaSymbol from '../symbols/TwoColorHybridManaSymbol.js';
+import UntapSymbol from '../symbols/UntapSymbol.js';
+import VariableManaSymbol from '../symbols/VariableManaSymbol.js';
+
+export default class ActivationCost extends Cost {
+    static get allowedSymbols() {
+        return [
+            HybridPhyrexianManaSymbol, ColoredPhyrexianManaSymbol,
+            GenericHybridManaSymbol, FiveColorHybridManaSymbol,
+            FourColorHybridManaSymbol, ThreeColorHybridManaSymbol,
+            TwoColorHybridManaSymbol, HalfManaSymbol, ColorlessPhyrexianManaSymbol,
+            GenericManaSymbol, VariableManaSymbol, InfiniteManaSymbol,
+            TypedManaSymbol, ColoredManaSymbol, ColorlessManaSymbol,
+            ExtraSymbol, TapSymbol, UntapSymbol,
+        ];
+    }
+}

package/src/costs/Cost.js

@@ -1,48 +1,50 @@
-import { NotImplementedError } from '../customErrors.js';
-
-export default class Cost {
-    static get allowedSymbols() {
-        throw new NotImplementedError('allowedSymbols');
-    }
-
-    static parse(str) {
-        const cost = new this();
-        cost.parseSymbols(str);
-        return cost;
-    }
-
-    constructor(symbols = []) {
-        this.symbols = symbols;
-    }
-
-    get colors() {
-        const set = new Set(this.symbols.flatMap(sym => sym.colors));
-        return [...set];
-    }
-
-    parseSymbols(str) {
-        let remainingStr = str.trim();
-        while (remainingStr.length) {
-            const symbol = this.parseNextSymbol(remainingStr);
-            if (!symbol) break;
-            symbol.apply(this.symbols);
-            if (remainingStr === symbol.remainingStr) break;
-            remainingStr = symbol.remainingStr;
-        }
-        this.remainingStr = remainingStr;
-    }
-
-    parseNextSymbol(str) {
-        for (const symbol of this.constructor.allowedSymbols) {
-            const match = symbol.match(str);
-            if (!match) continue;
-            return symbol.parse(match, str);
-        }
-    }
-
-    toString(useBraces = false) {
-        return this.symbols.map(sym => {
-            return sym.toString(useBraces);
-        }).join('');
-    }
-}
+import { NotImplementedError } from '../customErrors.js';
+
+export default class Cost {
+    static get allowedSymbols() {
+        throw new NotImplementedError('allowedSymbols');
+    }
+
+    static parse(str) {
+        const cost = new this();
+        cost.parseSymbols(str);
+        return cost;
+    }
+
+    constructor(symbols = []) {
+        this.symbols = symbols;
+    }
+
+    get colors() {
+        const set = new Set(this.symbols.flatMap(sym => sym.colors));
+        return [...set];
+    }
+
+    parseSymbols(str) {
+        let remainingStr = str.trim();
+        while (remainingStr.length) {
+            const symbol = this.parseNextSymbol(remainingStr);
+            if (!symbol) break;
+            symbol.apply(this.symbols);
+            if (remainingStr === symbol.remainingStr) break;
+            remainingStr = symbol.remainingStr;
+        }
+        this.remainingStr = remainingStr;
+    }
+
+    parseNextSymbol(str) {
+        for (const symbol of this.constructor.allowedSymbols) {
+            const match = symbol.match(str);
+            if (!match) continue;
+            return symbol.parse(match, str);
+        }
+    }
+
+    toString(useBraces = false) {
+        return this.symbols.sort((a, b) => {
+            return a.sortIndex - b.sortIndex;
+        }).map(sym => {
+            return sym.toString(useBraces);
+        }).join('');
+    }
+}