@logic-pad/core 0.26.0 → 0.26.2

package/dist/src/data/rules/wrapAroundRule.js

@@ -1,241 +0,0 @@
-import { ConfigType } from '../config.js';
-import { array } from '../dataHelper.js';
-import GridData from '../grid.js';
-import { Color, MajorRule, Orientation, State, Wrapping, orientationToggle, } from '../primitives.js';
-import LetterSymbol from '../symbols/letterSymbol.js';
-import MyopiaSymbol from '../symbols/myopiaSymbol.js';
-import Rule from './rule.js';
-export default class WrapAroundRule extends Rule {
-    horizontal;
-    vertical;
-    title = 'Wrap Around';
-    get configExplanation() {
-        return 'Allow edges to connect with each other and symbols / rules to take effect across edges.';
-    }
-    static EXAMPLE_GRID_NONE = Object.freeze(GridData.create(['wwwww', 'wwwww', 'wwwww', 'wwwww', 'wwwww']));
-    static EXAMPLE_GRID_HORIZONTAL = Object.freeze({
-        [Wrapping.None]: WrapAroundRule.EXAMPLE_GRID_NONE,
-        [Wrapping.Wrap]: GridData.create([
-            'wwwww',
-            'bwwwb',
-            'wwwww',
-            'bwwwb',
-            'wwwww',
-        ])
-            .addSymbol(new LetterSymbol(0, 1, 'A'))
-            .addSymbol(new LetterSymbol(4, 1, 'A'))
-            .addSymbol(new LetterSymbol(0, 3, 'B'))
-            .addSymbol(new LetterSymbol(4, 3, 'B')),
-        [Wrapping.WrapReverse]: GridData.create([
-            'wwwww',
-            'bwwwb',
-            'wwwww',
-            'bwwwb',
-            'wwwww',
-        ])
-            .addSymbol(new LetterSymbol(0, 1, 'A'))
-            .addSymbol(new LetterSymbol(4, 1, 'B'))
-            .addSymbol(new LetterSymbol(0, 3, 'B'))
-            .addSymbol(new LetterSymbol(4, 3, 'A')),
-        [Wrapping.ReflectReverse]: GridData.create([
-            'wwwww',
-            'bwwww',
-            'wwwww',
-            'wwwwb',
-            'wwwww',
-        ])
-            .addSymbol(new MyopiaSymbol(0, 3, false, orientationToggle(Orientation.Left)))
-            .addSymbol(new MyopiaSymbol(4, 1, false, orientationToggle(Orientation.Right))),
-    });
-    static EXAMPLE_GRID_VERTICAL = Object.freeze({
-        [Wrapping.None]: WrapAroundRule.EXAMPLE_GRID_NONE,
-        [Wrapping.Wrap]: GridData.create([
-            'wbwbw',
-            'wwwww',
-            'wwwww',
-            'wwwww',
-            'wbwbw',
-        ])
-            .addSymbol(new LetterSymbol(1, 0, 'C'))
-            .addSymbol(new LetterSymbol(3, 0, 'D'))
-            .addSymbol(new LetterSymbol(1, 4, 'C'))
-            .addSymbol(new LetterSymbol(3, 4, 'D')),
-        [Wrapping.WrapReverse]: GridData.create([
-            'wbwbw',
-            'wwwww',
-            'wwwww',
-            'wwwww',
-            'wbwbw',
-        ])
-            .addSymbol(new LetterSymbol(1, 0, 'C'))
-            .addSymbol(new LetterSymbol(3, 0, 'D'))
-            .addSymbol(new LetterSymbol(1, 4, 'D'))
-            .addSymbol(new LetterSymbol(3, 4, 'C')),
-        [Wrapping.ReflectReverse]: GridData.create([
-            'wbwww',
-            'wwwww',
-            'wwwww',
-            'wwwww',
-            'wwwbw',
-        ])
-            .addSymbol(new MyopiaSymbol(3, 0, false, orientationToggle(Orientation.Up)))
-            .addSymbol(new MyopiaSymbol(1, 4, false, orientationToggle(Orientation.Down))),
-    });
-    static SEARCH_VARIANTS = [
-        new WrapAroundRule(Wrapping.Wrap, Wrapping.None).searchVariant(),
-        new WrapAroundRule(Wrapping.None, Wrapping.Wrap).searchVariant(),
-        new WrapAroundRule(Wrapping.Wrap, Wrapping.Wrap).searchVariant(),
-        new WrapAroundRule(Wrapping.ReflectReverse, Wrapping.None).searchVariant(),
-        new WrapAroundRule(Wrapping.None, Wrapping.ReflectReverse).searchVariant(),
-        new WrapAroundRule(Wrapping.ReflectReverse, Wrapping.ReflectReverse).searchVariant(),
-    ];
-    static CONFIGS = Object.freeze([
-        {
-            type: ConfigType.Wrapping,
-            default: Wrapping.Wrap,
-            field: 'horizontal',
-            description: 'Horizontal wrap',
-            configurable: true,
-        },
-        {
-            type: ConfigType.Wrapping,
-            default: Wrapping.Wrap,
-            field: 'vertical',
-            description: 'Vertical wrap',
-            configurable: true,
-        },
-    ]);
-    /**
-     * **The left and right edges are connected (in reverse)**
-     *
-     * @param horizontal - The horizontal wrapping.
-     * @param vertical - The vertical wrapping.
-     */
-    constructor(horizontal, vertical) {
-        super();
-        this.horizontal = horizontal;
-        this.vertical = vertical;
-        this.horizontal = horizontal;
-        this.vertical = vertical;
-    }
-    onGetTile(x, y, grid) {
-        if (grid.width === 0 || grid.height === 0) {
-            return { x, y };
-        }
-        if (this.horizontal !== Wrapping.None) {
-            const idx = Math.abs(Math.floor(x / grid.width));
-            x = ((x % grid.width) + grid.width) % grid.width;
-            if ((this.horizontal === Wrapping.WrapReverse ||
-                this.horizontal === Wrapping.ReflectReverse) &&
-                idx % 2 === 1) {
-                y = grid.height - 1 - y;
-            }
-            if (this.horizontal === Wrapping.ReflectReverse && idx % 2 === 1) {
-                x = grid.width - 1 - x;
-            }
-        }
-        if (this.vertical !== Wrapping.None) {
-            const idx = Math.abs(Math.floor(y / grid.height));
-            y = ((y % grid.height) + grid.height) % grid.height;
-            if ((this.vertical === Wrapping.WrapReverse ||
-                this.vertical === Wrapping.ReflectReverse) &&
-                idx % 2 === 1) {
-                x = grid.width - 1 - x;
-            }
-            if (this.vertical === Wrapping.ReflectReverse && idx % 2 === 1) {
-                y = grid.height - 1 - y;
-            }
-        }
-        return { x, y };
-    }
-    get id() {
-        return MajorRule.WrapAround;
-    }
-    get explanation() {
-        if (this.horizontal === Wrapping.None && this.vertical === Wrapping.None) {
-            return `No edges are connected.`;
-        }
-        const horizontal = this.horizontal === Wrapping.None
-            ? null
-            : this.horizontal === Wrapping.Wrap ||
-                this.horizontal === Wrapping.WrapReverse
-                ? 'connected'
-                : 'reflective';
-        const vertical = this.vertical === Wrapping.None
-            ? null
-            : this.vertical === Wrapping.Wrap ||
-                this.vertical === Wrapping.WrapReverse
-                ? 'connected'
-                : 'reflective';
-        const horizontalReverse = this.horizontal === Wrapping.WrapReverse ||
-            this.horizontal === Wrapping.ReflectReverse
-            ? ' in reverse'
-            : '';
-        const verticalReverse = this.vertical === Wrapping.WrapReverse ||
-            this.vertical === Wrapping.ReflectReverse
-            ? ' in reverse'
-            : '';
-        if (this.horizontal === this.vertical) {
-            return `All four edges are ${horizontal}${horizontalReverse}.`;
-        }
-        if (this.horizontal === Wrapping.None) {
-            return `The top and bottom edges are ${vertical}${verticalReverse}.`;
-        }
-        if (this.vertical === Wrapping.None) {
-            return `The left and right edges are ${horizontal}${horizontalReverse}.`;
-        }
-        if (horizontal === vertical) {
-            if (horizontalReverse !== '') {
-                return `All four edges are ${horizontal}, with the left and right edges${horizontalReverse}.`;
-            }
-            else {
-                return `All four edges are ${horizontal}, with the top and bottom edges${verticalReverse}.`;
-            }
-        }
-        return `The left and right edges are ${horizontal}${horizontalReverse}. The top and bottom edges are ${vertical}${verticalReverse}.`;
-    }
-    createExampleGrid() {
-        const horizontal = WrapAroundRule.EXAMPLE_GRID_HORIZONTAL[this.horizontal];
-        const vertical = WrapAroundRule.EXAMPLE_GRID_VERTICAL[this.vertical];
-        if (horizontal === WrapAroundRule.EXAMPLE_GRID_NONE) {
-            return vertical;
-        }
-        else if (vertical === WrapAroundRule.EXAMPLE_GRID_NONE) {
-            return horizontal;
-        }
-        else {
-            const tiles = array(5, 5, (x, y) => {
-                const hTile = horizontal.getTile(x, y);
-                const vTile = vertical.getTile(x, y);
-                return hTile.withColor(hTile.color === Color.Dark || vTile.color === Color.Dark
-                    ? Color.Dark
-                    : Color.Light);
-            });
-            const symbols = [];
-            horizontal.symbols.forEach(list => symbols.push(...list));
-            vertical.symbols.forEach(list => symbols.push(...list));
-            return horizontal.withTiles(tiles).withSymbols(symbols);
-        }
-    }
-    get configs() {
-        return WrapAroundRule.CONFIGS;
-    }
-    get searchVariants() {
-        return WrapAroundRule.SEARCH_VARIANTS;
-    }
-    validateGrid(grid) {
-        if (grid.getTileCount(true, false, Color.Gray) > 0) {
-            return { state: State.Incomplete };
-        }
-        else {
-            return { state: State.Satisfied };
-        }
-    }
-    copyWith({ horizontal, vertical, }) {
-        return new WrapAroundRule(horizontal ?? this.horizontal, vertical ?? this.vertical);
-    }
-    get isSingleton() {
-        return true;
-    }
-}
-export const instance = new WrapAroundRule(Wrapping.Wrap, Wrapping.Wrap);

package/dist/src/data/serializer/allSerializers.d.ts

@@ -1,32 +0,0 @@
-import GridData from '../grid.js';
-import { Puzzle, PuzzleData } from '../puzzle.js';
-import Rule from '../rules/rule.js';
-import Symbol from '../symbols/symbol.js';
-/**
- * The master serializer for puzzles.
- *
- * It uses the default serializer when stringifying puzzles, and select the correct deserializer when parsing puzzles.
- */
-declare const Serializer: {
-    stringifyRule(rule: Rule): string;
-    parseRule(input: string): Rule;
-    stringifySymbol(symbol: Symbol): string;
-    parseSymbol(input: string): Symbol;
-    stringifyGrid(grid: GridData): string;
-    parseGrid(input: string): GridData;
-    stringifyGridWithSolution(puzzle: PuzzleData): string;
-    parseGridWithSolution(input: string): PuzzleData;
-    /**
-     * Convert a puzzle to a string.
-     * @param puzzle The puzzle to convert.
-     * @returns The string representation of the puzzle.
-     */
-    stringifyPuzzle(puzzle: Puzzle): string;
-    /**
-     * Parse a puzzle from a string.
-     * @param input The string to parse.
-     * @returns The parsed puzzle.
-     */
-    parsePuzzle(input: string): Puzzle;
-};
-export { Serializer };

package/dist/src/data/serializer/allSerializers.js

@@ -1,71 +0,0 @@
-import SerializerV0 from './serializer_v0.js';
-const allSerializers = new Map();
-function register(prototype) {
-    allSerializers.set(prototype.version, prototype);
-}
-let defaultSerializer;
-register((defaultSerializer = new SerializerV0()));
-function selectSerializer(input) {
-    const match = /^(\d+)_/.exec(input);
-    const version = match ? parseInt(match[1]) : 0;
-    const serializer = allSerializers.get(version);
-    if (serializer) {
-        return { serializer, data: input.slice(match?.[0].length ?? 0) };
-    }
-    else {
-        throw new Error(`Unknown serializer version for ${input}`);
-    }
-}
-/**
- * The master serializer for puzzles.
- *
- * It uses the default serializer when stringifying puzzles, and select the correct deserializer when parsing puzzles.
- */
-const Serializer = {
-    stringifyRule(rule) {
-        return `${defaultSerializer.version}_${defaultSerializer.stringifyRule(rule)}`;
-    },
-    parseRule(input) {
-        const { serializer, data } = selectSerializer(input);
-        return serializer.parseRule(data);
-    },
-    stringifySymbol(symbol) {
-        return `${defaultSerializer.version}_${defaultSerializer.stringifySymbol(symbol)}`;
-    },
-    parseSymbol(input) {
-        const { serializer, data } = selectSerializer(input);
-        return serializer.parseSymbol(data);
-    },
-    stringifyGrid(grid) {
-        return `${defaultSerializer.version}_${defaultSerializer.stringifyGrid(grid)}`;
-    },
-    parseGrid(input) {
-        const { serializer, data } = selectSerializer(input);
-        return serializer.parseGrid(data);
-    },
-    stringifyGridWithSolution(puzzle) {
-        return `${defaultSerializer.version}_${defaultSerializer.stringifyGridWithSolution(puzzle)}`;
-    },
-    parseGridWithSolution(input) {
-        const { serializer, data } = selectSerializer(input);
-        return serializer.parseGridWithSolution(data);
-    },
-    /**
-     * Convert a puzzle to a string.
-     * @param puzzle The puzzle to convert.
-     * @returns The string representation of the puzzle.
-     */
-    stringifyPuzzle(puzzle) {
-        return `${defaultSerializer.version}_${defaultSerializer.stringifyPuzzle(puzzle)}`;
-    },
-    /**
-     * Parse a puzzle from a string.
-     * @param input The string to parse.
-     * @returns The parsed puzzle.
-     */
-    parsePuzzle(input) {
-        const { serializer, data } = selectSerializer(input);
-        return serializer.parsePuzzle(data);
-    },
-};
-export { Serializer };

package/dist/src/data/serializer/compressor/allCompressors.d.ts

@@ -1,14 +0,0 @@
-import CompressorBase from './compressorBase.js';
-/**
- * The master compressor for compressing and decompressing strings.
- *
- * It compares the output of multiple compressors and selects the one with the smallest size (slow),
- * and selects the correct decompressor when decompressing.
- */
-declare class MasterCompressor extends CompressorBase {
-    get id(): string;
-    compress(input: string): Promise<string>;
-    decompress(input: string): Promise<string>;
-}
-declare const Compressor: MasterCompressor;
-export { Compressor };

package/dist/src/data/serializer/compressor/allCompressors.js

@@ -1,43 +0,0 @@
-import { minBy } from '../../dataHelper.js';
-import CompressorBase from './compressorBase.js';
-import GzipCompressor from './gzipCompressor.js';
-import DeflateCompressor from './deflateCompressor.js';
-const allCompressors = new Map();
-function register(prototype) {
-    allCompressors.set(prototype.id, prototype);
-}
-const activeCompressors = [new DeflateCompressor()];
-activeCompressors.forEach(register);
-register(new GzipCompressor());
-/**
- * The master compressor for compressing and decompressing strings.
- *
- * It compares the output of multiple compressors and selects the one with the smallest size (slow),
- * and selects the correct decompressor when decompressing.
- */
-class MasterCompressor extends CompressorBase {
-    get id() {
-        return `compressor`;
-    }
-    async compress(input) {
-        const compressed = await Promise.all(activeCompressors.map(async (compressor) => `${compressor.id}_${await compressor.compress(input)}`));
-        return minBy(compressed, c => encodeURIComponent(c).length) ?? '';
-    }
-    async decompress(input) {
-        const match = /^([^_]+?)_(.+)$/.exec(input);
-        let compressorId;
-        let compressed;
-        if (match) {
-            compressorId = match[1];
-            compressed = match[2];
-        }
-        else {
-            compressorId = 'gzip';
-            compressed = input;
-        }
-        const compressor = allCompressors.get(compressorId);
-        return compressor.decompress(compressed);
-    }
-}
-const Compressor = new MasterCompressor();
-export { Compressor };

package/dist/src/data/serializer/compressor/checksumCompressor.d.ts

@@ -1,6 +0,0 @@
-import CompressorBase from './compressorBase.js';
-export default class ChecksumCompressor extends CompressorBase {
-    get id(): string;
-    compress(input: string): Promise<string>;
-    decompress(_input: string): Promise<string>;
-}

package/dist/src/data/serializer/compressor/checksumCompressor.js

@@ -1,21 +0,0 @@
-import SerializerChecksum from '../serializer_checksum.js';
-import CompressorBase from './compressorBase.js';
-const checksumSerializer = new SerializerChecksum();
-const encoder = new TextEncoder();
-export default class ChecksumCompressor extends CompressorBase {
-    get id() {
-        return `cs${checksumSerializer.version}`;
-    }
-    async compress(input) {
-        const data = encoder.encode(input);
-        const hashBuffer = await crypto.subtle.digest('SHA-256', data);
-        const hashArray = Array.from(new Uint8Array(hashBuffer));
-        const hashHex = hashArray
-            .map(b => b.toString(16).padStart(2, '0'))
-            .join('');
-        return `${this.id}_${hashHex}`;
-    }
-    decompress(_input) {
-        throw new Error('Checksum decompression is not supported');
-    }
-}

package/dist/src/data/serializer/compressor/compressorBase.d.ts

@@ -1,16 +0,0 @@
-export default abstract class CompressorBase {
-    /**
-     * The unique identifier for this compressor.
-     */
-    abstract get id(): string;
-    /**
-     * Compress the given input string into URL-safe compressed string.
-     * @param input The input string to compress.
-     */
-    abstract compress(input: string): Promise<string>;
-    /**
-     * Decompress the given compressed string back into the original string.
-     * @param input The compressed string to decompress.
-     */
-    abstract decompress(input: string): Promise<string>;
-}

package/dist/src/data/serializer/compressor/compressorBase.js

@@ -1,2 +0,0 @@
-export default class CompressorBase {
-}

package/dist/src/data/serializer/compressor/deflateCompressor.d.ts

@@ -1,7 +0,0 @@
-import StreamCompressor from './streamCompressor.js';
-export default class DeflateCompressor extends StreamCompressor {
-    get id(): string;
-    protected get algorithm(): CompressionFormat;
-    compress(input: string): Promise<string>;
-    decompress(input: string): Promise<string>;
-}

package/dist/src/data/serializer/compressor/deflateCompressor.js

@@ -1,17 +0,0 @@
-import StreamCompressor from './streamCompressor.js';
-export default class DeflateCompressor extends StreamCompressor {
-    get id() {
-        return `dfl`;
-    }
-    get algorithm() {
-        return 'deflate-raw';
-    }
-    async compress(input) {
-        const result = await super.compress(input);
-        return result.replace(/\+/g, '-').replace(/\//g, '_');
-    }
-    async decompress(input) {
-        input = input.replace(/-/g, '+').replace(/_/g, '/');
-        return await super.decompress(input);
-    }
-}

package/dist/src/data/serializer/compressor/gzipCompressor.d.ts

@@ -1,5 +0,0 @@
-import StreamCompressor from './streamCompressor.js';
-export default class GzipCompressor extends StreamCompressor {
-    get id(): string;
-    protected get algorithm(): CompressionFormat;
-}

package/dist/src/data/serializer/compressor/gzipCompressor.js

@@ -1,9 +0,0 @@
-import StreamCompressor from './streamCompressor.js';
-export default class GzipCompressor extends StreamCompressor {
-    get id() {
-        return `gzip`;
-    }
-    get algorithm() {
-        return 'gzip';
-    }
-}

package/dist/src/data/serializer/compressor/streamCompressor.d.ts

@@ -1,6 +0,0 @@
-import CompressorBase from './compressorBase.js';
-export default abstract class StreamCompressor extends CompressorBase {
-    protected abstract get algorithm(): CompressionFormat;
-    compress(input: string): Promise<string>;
-    decompress(input: string): Promise<string>;
-}

package/dist/src/data/serializer/compressor/streamCompressor.js

@@ -1,41 +0,0 @@
-import CompressorBase from './compressorBase.js';
-function ensureCompressionStream() {
-    if (!globalThis.CompressionStream || !globalThis.DecompressionStream) {
-        console.log('CompressionStream not supported. Loading polyfill.');
-        return import('../../../polyfill/streamPolyfill.js');
-    }
-    return Promise.resolve();
-}
-const encoder = new TextEncoder();
-const decoder = new TextDecoder();
-export default class StreamCompressor extends CompressorBase {
-    async compress(input) {
-        await ensureCompressionStream();
-        const blobToBase64 = (blob) => new Promise(resolve => {
-            const reader = new FileReader();
-            reader.onloadend = () => resolve(reader.result.split(',')[1]);
-            reader.readAsDataURL(blob);
-        });
-        const byteArray = encoder.encode(input);
-        const cs = new CompressionStream(this.algorithm);
-        const writer = cs.writable.getWriter();
-        writer.ready
-            .then(() => writer.write(byteArray))
-            .then(() => writer.close())
-            .catch(console.log);
-        return new Response(cs.readable).blob().then(blobToBase64);
-    }
-    async decompress(input) {
-        await ensureCompressionStream();
-        const bytes = Uint8Array.from(atob(input), c => c.charCodeAt(0));
-        const cs = new DecompressionStream(this.algorithm);
-        const writer = cs.writable.getWriter();
-        writer.ready
-            .then(() => writer.write(bytes))
-            .then(() => writer.close())
-            .catch(console.log);
-        return new Response(cs.readable).arrayBuffer().then(arrayBuffer => {
-            return decoder.decode(arrayBuffer);
-        });
-    }
-}

package/dist/src/data/serializer/serializerBase.d.ts

@@ -1,32 +0,0 @@
-import GridData from '../grid.js';
-import GridConnections from '../gridConnections.js';
-import Rule from '../rules/rule.js';
-import TileData from '../tile.js';
-import Symbol from '../symbols/symbol.js';
-import { Puzzle, PuzzleData } from '../puzzle.js';
-import GridZones from '../gridZones.js';
-export default abstract class SerializerBase {
-    abstract get version(): number;
-    abstract stringifyTile(tile: TileData): string;
-    abstract parseTile(str: string): TileData;
-    abstract stringifyRule(rule: Rule): string;
-    abstract stringifySymbol(symbol: Symbol): string;
-    abstract parseRule(str: string): Rule;
-    abstract parseSymbol(str: string): Symbol;
-    abstract stringifyConnections(connections: GridConnections): string;
-    abstract parseConnections(input: string): GridConnections;
-    abstract stringifyZones(zones: GridZones): string;
-    abstract parseZones(input: string): GridZones;
-    abstract stringifyTiles(tiles: readonly (readonly TileData[])[]): string;
-    abstract parseTiles(input: string): TileData[][];
-    abstract stringifyRules(rules: readonly Rule[]): string;
-    abstract parseRules(input: string): Rule[];
-    abstract stringifySymbols(symbols: ReadonlyMap<string, readonly Symbol[]>): string;
-    abstract parseSymbols(input: string): Map<string, Symbol[]>;
-    abstract stringifyGrid(grid: GridData): string;
-    abstract parseGrid(input: string): GridData;
-    abstract stringifyGridWithSolution(puzzle: PuzzleData): string;
-    abstract parseGridWithSolution(input: string): PuzzleData;
-    abstract stringifyPuzzle(puzzle: Puzzle): string;
-    abstract parsePuzzle(input: string): Puzzle;
-}

package/dist/src/data/serializer/serializerBase.js

@@ -1,2 +0,0 @@
-export default class SerializerBase {
-}

package/dist/src/data/serializer/serializer_checksum.d.ts

@@ -1,35 +0,0 @@
-import GridData from '../grid.js';
-import GridConnections from '../gridConnections.js';
-import Rule from '../rules/rule.js';
-import TileData from '../tile.js';
-import Symbol from '../symbols/symbol.js';
-import { AnyConfig } from '../config.js';
-import { Puzzle, PuzzleData } from '../puzzle.js';
-import { ControlLine } from '../rules/musicControlLine.js';
-import GridZones from '../gridZones.js';
-import SerializerV0 from './serializer_v0.js';
-import Instruction from '../instruction.js';
-export default class SerializerChecksum extends SerializerV0 {
-    readonly version: number;
-    parseTile(_str: string): TileData;
-    stringifyControlLine(line: ControlLine): string;
-    parseControlLine(_str: string): ControlLine;
-    stringifyConfig(instruction: Instruction, config: AnyConfig): string;
-    parseConfig(_configs: readonly AnyConfig[], _entry: string): [string, unknown];
-    parseRule(_str: string): Rule;
-    parseSymbol(_str: string): Symbol;
-    parseConnections(_input: string): GridConnections;
-    stringifyZones(zones: GridZones): string;
-    parseZones(_input: string): GridZones;
-    parseTiles(_input: string): TileData[][];
-    stringifyRules(rules: readonly Rule[]): string;
-    parseRules(_input: string): Rule[];
-    stringifySymbols(symbols: ReadonlyMap<string, readonly Symbol[]>): string;
-    parseSymbols(_input: string): Map<string, Symbol[]>;
-    stringifyGrid(grid: GridData): string;
-    parseGrid(_input: string): GridData;
-    stringifyGridWithSolution(puzzle: PuzzleData): string;
-    parseGridWithSolution(_input: string): PuzzleData;
-    stringifyPuzzle(puzzle: Puzzle): string;
-    parsePuzzle(_input: string): Puzzle;
-}