puzzle-lib 1.7.0 → 2.0.0-alpha.1

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2018 Kyle Farnung
-
-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.
+MIT License
+
+Copyright (c) 2018 Kyle Farnung
+
+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,38 +1,50 @@
-# puzzle-lib
-
-![puzzle-lib CI](https://github.com/puzztool/puzzle-lib/workflows/puzzle-lib%20CI/badge.svg)
-[![npm](https://img.shields.io/npm/v/puzzle-lib.svg)](https://www.npmjs.com/package/puzzle-lib)
-
-Library of puzzle-solving algorithms
-
-## Usage
-
-```console
-$ npm install --save puzzle-lib
-```
-
-```js
-const { MorseCharacter } = require('puzzle-lib');
-const ch = new MorseCharacter();
-ch.dot();
-console.log(ch.toString());
-```
-
-## Contributing
-
-The library code is written in TypeScript and produces ECMAScript 5 output. The test code is written in JavaScript using
-[Mocha](https://mochajs.org/).
-
-```console
-$ git clone https://github.com/puzztool/puzzle-lib.git
-$ cd puzzle-lib
-$ npm install
-$ npm test
-```
-
-To use local changes in another project:
-
-```console
-$ cd <path to other project>
-$ npm link <path to puzzle-lib>
-```
+# puzzle-lib
+
+![puzzle-lib CI](https://github.com/puzztool/puzzle-lib/workflows/puzzle-lib%20CI/badge.svg)
+[![npm](https://img.shields.io/npm/v/puzzle-lib.svg)](https://www.npmjs.com/package/puzzle-lib)
+
+Library of puzzle-solving algorithms
+
+## Usage
+
+```console
+$ npm install --save puzzle-lib
+```
+
+```ts
+import { decodeMorse, caesarRotations, vigenereEncrypt } from 'puzzle-lib';
+
+// Decode morse code
+decodeMorse('.----/..---/...--'); // '123'
+
+// Get all Caesar cipher rotations
+caesarRotations('hello');
+
+// Vigenère encrypt
+vigenereEncrypt('hello', 'key');
+```
+
+## Contributing
+
+The library and tests are written in TypeScript. Tests use
+[Vitest](https://vitest.dev/).
+
+```console
+$ git clone https://github.com/puzztool/puzzle-lib.git
+$ cd puzzle-lib
+$ npm install
+$ npm test
+```
+
+To lint:
+
+```console
+$ npm run lint
+```
+
+To use local changes in another project:
+
+```console
+$ cd <path to other project>
+$ npm link <path to puzzle-lib>
+```

package/build/src/Braille/braille.d.ts

@@ -0,0 +1,20 @@
+import { EncodingCategory } from '../Common/EncodingCategory';
+import { EncodingLookupResult } from '../Common/EncodingLookupResult';
+import { BrailleDot } from './BrailleDot';
+import { BrailleEncoding } from './BrailleEncoding';
+/**
+ * Looks up a braille encoding in the data table.
+ */
+export declare function lookupBrailleEncoding(encoding: BrailleEncoding, category?: EncodingCategory): EncodingLookupResult<BrailleEncoding>;
+/**
+ * Toggles a dot (or encoding bitmask) on/off, returns the new encoding.
+ */
+export declare function toggleBrailleDot(encoding: BrailleEncoding, dot: BrailleDot | BrailleEncoding): BrailleEncoding;
+/**
+ * Checks if a dot (or encoding bitmask) is set.
+ */
+export declare function getBrailleDot(encoding: BrailleEncoding, dot: BrailleDot | BrailleEncoding): boolean;
+/**
+ * Decodes an array of braille encodings to a string, handling number mode.
+ */
+export declare function decodeBrailleStream(encodings: BrailleEncoding[]): string;

package/build/src/Braille/braille.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookupBrailleEncoding = lookupBrailleEncoding;
+exports.toggleBrailleDot = toggleBrailleDot;
+exports.getBrailleDot = getBrailleDot;
+exports.decodeBrailleStream = decodeBrailleStream;
+const EncodingCategory_1 = require("../Common/EncodingCategory");
+const EncodingEntry_1 = require("../Common/EncodingEntry");
+const EncodingLookupResult_1 = require("../Common/EncodingLookupResult");
+const BrailleEncoding_1 = require("./BrailleEncoding");
+// Build the lookup table once
+const BRAILLE_ENTRIES = [];
+function addEntry(encoding, category, display) {
+    BRAILLE_ENTRIES.push(new EncodingEntry_1.EncodingEntry(encoding, category, display));
+}
+// Letters
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterA, EncodingCategory_1.EncodingCategory.Letter, 'A');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterB, EncodingCategory_1.EncodingCategory.Letter, 'B');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterC, EncodingCategory_1.EncodingCategory.Letter, 'C');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterD, EncodingCategory_1.EncodingCategory.Letter, 'D');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterE, EncodingCategory_1.EncodingCategory.Letter, 'E');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterF, EncodingCategory_1.EncodingCategory.Letter, 'F');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterG, EncodingCategory_1.EncodingCategory.Letter, 'G');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterH, EncodingCategory_1.EncodingCategory.Letter, 'H');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterI, EncodingCategory_1.EncodingCategory.Letter, 'I');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterJ, EncodingCategory_1.EncodingCategory.Letter, 'J');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterK, EncodingCategory_1.EncodingCategory.Letter, 'K');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterL, EncodingCategory_1.EncodingCategory.Letter, 'L');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterM, EncodingCategory_1.EncodingCategory.Letter, 'M');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterN, EncodingCategory_1.EncodingCategory.Letter, 'N');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterO, EncodingCategory_1.EncodingCategory.Letter, 'O');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterP, EncodingCategory_1.EncodingCategory.Letter, 'P');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterQ, EncodingCategory_1.EncodingCategory.Letter, 'Q');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterR, EncodingCategory_1.EncodingCategory.Letter, 'R');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterS, EncodingCategory_1.EncodingCategory.Letter, 'S');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterT, EncodingCategory_1.EncodingCategory.Letter, 'T');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterU, EncodingCategory_1.EncodingCategory.Letter, 'U');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterV, EncodingCategory_1.EncodingCategory.Letter, 'V');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterW, EncodingCategory_1.EncodingCategory.Letter, 'W');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterX, EncodingCategory_1.EncodingCategory.Letter, 'X');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterY, EncodingCategory_1.EncodingCategory.Letter, 'Y');
+addEntry(BrailleEncoding_1.BrailleEncoding.LetterZ, EncodingCategory_1.EncodingCategory.Letter, 'Z');
+// Numbers
+addEntry(BrailleEncoding_1.BrailleEncoding.Number0, EncodingCategory_1.EncodingCategory.Number, '0');
+addEntry(BrailleEncoding_1.BrailleEncoding.Number1, EncodingCategory_1.EncodingCategory.Number, '1');
+addEntry(BrailleEncoding_1.BrailleEncoding.Number2, EncodingCategory_1.EncodingCategory.Number, '2');
+addEntry(BrailleEncoding_1.BrailleEncoding.Number3, EncodingCategory_1.EncodingCategory.Number, '3');
+addEntry(BrailleEncoding_1.BrailleEncoding.Number4, EncodingCategory_1.EncodingCategory.Number, '4');
+addEntry(BrailleEncoding_1.BrailleEncoding.Number5, EncodingCategory_1.EncodingCategory.Number, '5');
+addEntry(BrailleEncoding_1.BrailleEncoding.Number6, EncodingCategory_1.EncodingCategory.Number, '6');
+addEntry(BrailleEncoding_1.BrailleEncoding.Number7, EncodingCategory_1.EncodingCategory.Number, '7');
+addEntry(BrailleEncoding_1.BrailleEncoding.Number8, EncodingCategory_1.EncodingCategory.Number, '8');
+addEntry(BrailleEncoding_1.BrailleEncoding.Number9, EncodingCategory_1.EncodingCategory.Number, '9');
+// Formatting
+addEntry(BrailleEncoding_1.BrailleEncoding.FormattingNumber, EncodingCategory_1.EncodingCategory.Formatting, '#');
+addEntry(BrailleEncoding_1.BrailleEncoding.FormattingCapital, EncodingCategory_1.EncodingCategory.Formatting, '^');
+// Punctuation
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationComma, EncodingCategory_1.EncodingCategory.Punctuation, ',');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationSemicolon, EncodingCategory_1.EncodingCategory.Punctuation, ';');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationApostrophe, EncodingCategory_1.EncodingCategory.Punctuation, "'");
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationColon, EncodingCategory_1.EncodingCategory.Punctuation, ':');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationHyphen, EncodingCategory_1.EncodingCategory.Punctuation, '-');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationDecimalPoint, EncodingCategory_1.EncodingCategory.Punctuation, '.');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationFullStop, EncodingCategory_1.EncodingCategory.Punctuation, '.');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationExclamationPoint, EncodingCategory_1.EncodingCategory.Punctuation, '!');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationOpenQuote, EncodingCategory_1.EncodingCategory.Punctuation, '"');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationQuestionMark, EncodingCategory_1.EncodingCategory.Punctuation, '?');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationCloseQuote, EncodingCategory_1.EncodingCategory.Punctuation, '"');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationBracket, EncodingCategory_1.EncodingCategory.Punctuation, '(');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationBracket, EncodingCategory_1.EncodingCategory.Punctuation, ')');
+addEntry(BrailleEncoding_1.BrailleEncoding.PunctuationSlash, EncodingCategory_1.EncodingCategory.Punctuation, '/');
+/**
+ * Looks up a braille encoding in the data table.
+ */
+function lookupBrailleEncoding(encoding, category = EncodingCategory_1.EncodingCategory.All) {
+    const result = new EncodingLookupResult_1.EncodingLookupResult();
+    for (const entry of BRAILLE_ENTRIES) {
+        if ((entry.category & category) !== 0) {
+            if (entry.encoding === encoding) {
+                result.exact.push(entry);
+            }
+            else if ((entry.encoding & encoding) === encoding) {
+                result.partial.push(entry);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Toggles a dot (or encoding bitmask) on/off, returns the new encoding.
+ */
+function toggleBrailleDot(encoding, dot) {
+    return encoding ^ dot;
+}
+/**
+ * Checks if a dot (or encoding bitmask) is set.
+ */
+function getBrailleDot(encoding, dot) {
+    return (encoding & dot) === dot;
+}
+/**
+ * Decodes an array of braille encodings to a string, handling number mode.
+ */
+function decodeBrailleStream(encodings) {
+    let result = '';
+    let numberMode = false;
+    for (const ch of encodings) {
+        if (ch === BrailleEncoding_1.BrailleEncoding.None) {
+            numberMode = false;
+            result += ' ';
+        }
+        else if (ch === BrailleEncoding_1.BrailleEncoding.FormattingNumber) {
+            numberMode = true;
+            result += '#';
+        }
+        else {
+            const category = EncodingCategory_1.EncodingCategory.Punctuation |
+                (numberMode ? EncodingCategory_1.EncodingCategory.Number : EncodingCategory_1.EncodingCategory.Letter);
+            const lookup = lookupBrailleEncoding(ch, category);
+            if (lookup.exact.length > 0) {
+                result += lookup.exact[0].toString();
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=braille.js.map

package/build/src/Braille/braille.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"braille.js","sourceRoot":"","sources":["../../../src/Braille/braille.ts"],"names":[],"mappings":"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"}

package/build/src/Cipher/cipher.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Returns true if the character is an ASCII letter (A-Z or a-z).
+ */
+export declare function isAlpha(ch: string): boolean;
+/**
+ * Rotates a single letter by the given amount, preserving case.
+ * Non-alpha characters are returned unchanged.
+ */
+export declare function rotateLetter(ch: string, rot: number): string;
+/**
+ * Applies a Caesar rotation to every character in the text.
+ */
+export declare function caesarRotate(text: string, rotation: number): string;
+/**
+ * Returns all 26 Caesar rotations of the text.
+ */
+export declare function caesarRotations(text: string): string[];
+/**
+ * Encrypts text using the Vigenère cipher with the given key.
+ */
+export declare function vigenereEncrypt(text: string, key: string): string;
+/**
+ * Decrypts text using the Vigenère cipher with the given key.
+ */
+export declare function vigenereDecrypt(text: string, key: string): string;
+/**
+ * Encrypts text using the Autokey cipher with the given key.
+ */
+export declare function autokeyEncrypt(text: string, key: string): string;
+/**
+ * Decrypts text using the Autokey cipher with the given key.
+ */
+export declare function autokeyDecrypt(text: string, key: string): string;

package/build/src/Cipher/cipher.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAlpha = isAlpha;
+exports.rotateLetter = rotateLetter;
+exports.caesarRotate = caesarRotate;
+exports.caesarRotations = caesarRotations;
+exports.vigenereEncrypt = vigenereEncrypt;
+exports.vigenereDecrypt = vigenereDecrypt;
+exports.autokeyEncrypt = autokeyEncrypt;
+exports.autokeyDecrypt = autokeyDecrypt;
+const characterConversion_1 = require("../Conversion/characterConversion");
+const UPPER_A = 'A'.charCodeAt(0);
+const UPPER_Z = 'Z'.charCodeAt(0);
+const LOWER_A = 'a'.charCodeAt(0);
+const LOWER_Z = 'z'.charCodeAt(0);
+const ALPHA_LENGTH = 26;
+function isUpperAlpha(code) {
+    return code >= UPPER_A && code <= UPPER_Z;
+}
+function isLowerAlpha(code) {
+    return code >= LOWER_A && code <= LOWER_Z;
+}
+/**
+ * Returns true if the character is an ASCII letter (A-Z or a-z).
+ */
+function isAlpha(ch) {
+    const code = ch.charCodeAt(0);
+    return isUpperAlpha(code) || isLowerAlpha(code);
+}
+/**
+ * Rotates a single letter by the given amount, preserving case.
+ * Non-alpha characters are returned unchanged.
+ */
+function rotateLetter(ch, rot) {
+    if (ch.length !== 1) {
+        throw new Error('Expected a single character');
+    }
+    rot %= ALPHA_LENGTH;
+    if (rot < 0) {
+        rot += ALPHA_LENGTH;
+    }
+    const code = ch.charCodeAt(0);
+    let base = 0;
+    if (isLowerAlpha(code)) {
+        base = LOWER_A;
+    }
+    else if (isUpperAlpha(code)) {
+        base = UPPER_A;
+    }
+    else {
+        return ch;
+    }
+    return String.fromCharCode(((code - base + rot) % ALPHA_LENGTH) + base);
+}
+function rotateLetterWithKey(ch, key, keyIndex, decrypt) {
+    if (key.length === 0) {
+        return ch;
+    }
+    const keyCh = key.charAt(keyIndex % key.length);
+    let rot = (0, characterConversion_1.toOrdinal)(keyCh) - 1;
+    if (decrypt) {
+        rot = -rot;
+    }
+    return rotateLetter(ch, rot);
+}
+/**
+ * Applies a Caesar rotation to every character in the text.
+ */
+function caesarRotate(text, rotation) {
+    const result = [];
+    for (const ch of text) {
+        result.push(rotateLetter(ch, rotation));
+    }
+    return result.join('');
+}
+/**
+ * Returns all 26 Caesar rotations of the text.
+ */
+function caesarRotations(text) {
+    const rotations = [];
+    for (let i = 0; i < ALPHA_LENGTH; i++) {
+        rotations.push(caesarRotate(text, i));
+    }
+    return rotations;
+}
+/**
+ * Encrypts text using the Vigenère cipher with the given key.
+ */
+function vigenereEncrypt(text, key) {
+    const result = [];
+    let keyIndex = 0;
+    for (const ch of text) {
+        if (isAlpha(ch)) {
+            result.push(rotateLetterWithKey(ch, key, keyIndex++, false));
+        }
+        else {
+            result.push(ch);
+        }
+    }
+    return result.join('');
+}
+/**
+ * Decrypts text using the Vigenère cipher with the given key.
+ */
+function vigenereDecrypt(text, key) {
+    const result = [];
+    let keyIndex = 0;
+    for (const ch of text) {
+        if (isAlpha(ch)) {
+            result.push(rotateLetterWithKey(ch, key, keyIndex++, true));
+        }
+        else {
+            result.push(ch);
+        }
+    }
+    return result.join('');
+}
+/**
+ * Encrypts text using the Autokey cipher with the given key.
+ */
+function autokeyEncrypt(text, key) {
+    if (key.length < 1) {
+        return text;
+    }
+    const result = [];
+    let keyIndex = 0;
+    let fullKey = key;
+    for (const ch of text) {
+        if (isAlpha(ch)) {
+            result.push(rotateLetterWithKey(ch, fullKey, keyIndex++, false));
+            fullKey += ch;
+        }
+        else {
+            result.push(ch);
+        }
+    }
+    return result.join('');
+}
+/**
+ * Decrypts text using the Autokey cipher with the given key.
+ */
+function autokeyDecrypt(text, key) {
+    if (key.length < 1) {
+        return text;
+    }
+    const result = [];
+    let keyIndex = 0;
+    let fullKey = key;
+    for (const ch of text) {
+        if (isAlpha(ch)) {
+            const currentLetter = rotateLetterWithKey(ch, fullKey, keyIndex++, true);
+            result.push(currentLetter);
+            fullKey += currentLetter;
+        }
+        else {
+            result.push(ch);
+        }
+    }
+    return result.join('');
+}
+//# sourceMappingURL=cipher.js.map

package/build/src/Cipher/cipher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cipher.js","sourceRoot":"","sources":["../../../src/Cipher/cipher.ts"],"names":[],"mappings":"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"}

package/build/src/Conversion/CharacterEncoding.d.ts

@@ -1,9 +1,9 @@
 export declare enum CharacterEncoding {
     None = 0,
-    Latin = 1,
-    Ordinal = 2,
-    FiveBitBinary = 3,
-    EightBitBinary = 4,
-    Ascii = 5,
+    Latin = 1,// A = A, B = B
+    Ordinal = 2,// A = 1, B = 2
+    FiveBitBinary = 3,// 00001 = A, 00010 = B
+    EightBitBinary = 4,// 01100001 = A, 01100010 = B
+    Ascii = 5,// 65 = A, 66 = B
     Ternary = 6
 }

package/build/src/Conversion/characterConversion.d.ts

@@ -0,0 +1,17 @@
+import { CharacterTableEntry } from './CharacterTableEntry';
+/**
+ * Returns the ASCII code for a single character (0-127), or -1 if out of range.
+ */
+export declare function toAscii(ch: string): number;
+/**
+ * Returns the ordinal value of a letter (A=1, Z=26), or -1 if not a letter.
+ */
+export declare function toOrdinal(ch: string): number;
+/**
+ * Returns a table of ASCII characters with their representations in various bases.
+ */
+export declare function getAsciiTable(): CharacterTableEntry[];
+/**
+ * Returns a table of letters with their ordinal representations in various bases.
+ */
+export declare function getOrdinalTable(): CharacterTableEntry[];

package/build/src/Conversion/characterConversion.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toAscii = toAscii;
+exports.toOrdinal = toOrdinal;
+exports.getAsciiTable = getAsciiTable;
+exports.getOrdinalTable = getOrdinalTable;
+const CharacterTableEntry_1 = require("./CharacterTableEntry");
+function addAsciiRange(array, start, end, conversion, maxValue) {
+    for (let i = start; i <= end; i++) {
+        const letter = String.fromCharCode(i);
+        array.push(new CharacterTableEntry_1.CharacterTableEntry(letter, conversion(letter), maxValue));
+    }
+}
+/**
+ * Returns the ASCII code for a single character (0-127), or -1 if out of range.
+ */
+function toAscii(ch) {
+    if (typeof ch !== 'string' || ch.length !== 1) {
+        throw new Error('A single character is required');
+    }
+    const ascii = ch.charCodeAt(0);
+    if (ascii >= 0 && ascii <= 127) {
+        return ascii;
+    }
+    return -1;
+}
+/**
+ * Returns the ordinal value of a letter (A=1, Z=26), or -1 if not a letter.
+ */
+function toOrdinal(ch) {
+    if (typeof ch !== 'string' || ch.length !== 1) {
+        throw new Error('A single character is required');
+    }
+    const chCode = ch.charCodeAt(0);
+    let ordinalCode = chCode - 'a'.charCodeAt(0);
+    if (ordinalCode >= 0 && ordinalCode < 26) {
+        return ordinalCode + 1;
+    }
+    ordinalCode = chCode - 'A'.charCodeAt(0);
+    if (ordinalCode >= 0 && ordinalCode < 26) {
+        return ordinalCode + 1;
+    }
+    return -1;
+}
+/**
+ * Returns a table of ASCII characters with their representations in various bases.
+ */
+function getAsciiTable() {
+    const retVal = [];
+    addAsciiRange(retVal, 48, 57, toAscii, 127);
+    addAsciiRange(retVal, 65, 90, toAscii, 127);
+    addAsciiRange(retVal, 97, 122, toAscii, 127);
+    return retVal;
+}
+/**
+ * Returns a table of letters with their ordinal representations in various bases.
+ */
+function getOrdinalTable() {
+    const retVal = [];
+    addAsciiRange(retVal, 65, 90, toOrdinal, 26);
+    return retVal;
+}
+//# sourceMappingURL=characterConversion.js.map

package/build/src/Conversion/characterConversion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterConversion.js","sourceRoot":"","sources":["../../../src/Conversion/characterConversion.ts"],"names":[],"mappings":";;AAkBA,0BAWC;AAKD,8BAkBC;AAKD,sCAMC;AAKD,0CAIC;AAxED,+DAA0D;AAE1D,SAAS,aAAa,CACpB,KAA4B,EAC5B,KAAa,EACb,GAAW,EACX,UAAqC,EACrC,QAAgB;IAEhB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,IAAI,yCAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAC,EAAU;IAChC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/B,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAC,EAAU;IAClC,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAEhC,IAAI,WAAW,GAAG,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7C,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;QACzC,OAAO,WAAW,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,WAAW,GAAG,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,WAAW,IAAI,CAAC,IAAI,WAAW,GAAG,EAAE,EAAE,CAAC;QACzC,OAAO,WAAW,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa;IAC3B,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAC5C,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAC5C,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe;IAC7B,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,aAAa,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/src/Conversion/conversion.d.ts

@@ -0,0 +1,19 @@
+import { CharacterEncoding } from './CharacterEncoding';
+/**
+ * Determines the character encoding of a single input token.
+ */
+export declare function determineCharacterEncoding(input: string): CharacterEncoding;
+/**
+ * Converts a single token to a character based on its encoding.
+ * Optionally forces a specific encoding.
+ */
+export declare function convertCharacter(input: string, forcedCharacterEncoding?: CharacterEncoding): string;
+/**
+ * Determines the most common encoding across all tokens in a string.
+ */
+export declare function determineStringEncoding(input: string): CharacterEncoding;
+/**
+ * Converts a space-separated string by auto-detecting encoding.
+ * If homogeneous is true, all tokens use the same detected encoding.
+ */
+export declare function convertString(input: string, homogeneous: boolean): string;