@logic-pad/core 0.6.0 → 0.7.0

package/assets/logic-core.global.d.ts

@@ -29,6 +29,7 @@ declare global {
     MusicGrid = 'music',
     CompletePattern = 'complete_pattern',
     Underclued = 'underclued',
+    WrapAround = 'wrap_around',
   }
   export declare enum State {
     /**
@@ -81,6 +82,12 @@ declare global {
     AtMost = 'le',
   }
   export declare const COMPARISONS: readonly Comparison[];
+  export declare enum Wrapping {
+    None = 'none',
+    Wrap = 'wrap',
+    WrapReverse = 'wrap-reverse',
+  }
+  export declare const WRAPPINGS: readonly Wrapping[];
   export declare enum Direction {
     Up = 'up',
     Down = 'down',
@@ -560,7 +567,7 @@ declare global {
     get configs(): readonly AnyConfig[] | null;
     createExampleGrid(): GridData;
     get searchVariants(): SearchVariant[];
-    validateGrid(_grid: GridData): RuleState;
+    validateGrid(grid: GridData): RuleState;
     onSetGrid(
       _oldGrid: GridData,
       newGrid: GridData,
@@ -632,6 +639,45 @@ declare global {
     get validateWithSolution(): boolean;
     get isSingleton(): boolean;
   }
+  export interface GetTileHandler {
+    onGetTile(x: number, y: number, grid: GridData): Position$1;
+  }
+  export declare function handlesGetTile<T extends Instruction>(
+    val: T
+  ): val is T & GetTileHandler;
+  export declare class WrapAroundRule extends Rule implements GetTileHandler {
+    readonly horizontal: Wrapping;
+    readonly vertical: Wrapping;
+    private static readonly EXAMPLE_GRID_NONE;
+    private static readonly EXAMPLE_GRID_HORIZONTAL;
+    private static readonly EXAMPLE_GRID_HORIZONTAL_REVERSE;
+    private static readonly EXAMPLE_GRID_VERTICAL;
+    private static readonly EXAMPLE_GRID_VERTICAL_REVERSE;
+    private static readonly SEARCH_VARIANTS;
+    private static readonly CONFIGS;
+    /**
+     * **The left and right edges are connected (in reverse)**
+     *
+     * @param horizontal - The horizontal wrapping.
+     * @param vertical - The vertical wrapping.
+     */
+    constructor(horizontal: Wrapping, vertical: Wrapping);
+    onGetTile(x: number, y: number, grid: GridData): Position$1;
+    get id(): string;
+    get explanation(): string;
+    createExampleGrid(): GridData;
+    get configs(): readonly AnyConfig[] | null;
+    get searchVariants(): SearchVariant[];
+    validateGrid(grid: GridData): RuleState;
+    copyWith({
+      horizontal,
+      vertical,
+    }: {
+      horizontal?: Wrapping;
+      vertical?: Wrapping;
+    }): this;
+    get isSingleton(): boolean;
+  }
   export declare const NEIGHBOR_OFFSETS: Position$1[];
   export declare class GridData {
     readonly width: number;
@@ -644,6 +690,7 @@ declare global {
     readonly musicGrid: CachedAccess<MusicGridRule | undefined>;
     readonly completePattern: CachedAccess<CompletePatternRule | undefined>;
     readonly underclued: CachedAccess<UndercluedRule | undefined>;
+    readonly wrapAround: CachedAccess<WrapAroundRule | undefined>;
     /**
      * Create a new grid with tiles, connections, symbols and rules.
      *
@@ -742,6 +789,7 @@ declare global {
       symbols?: ReadonlyMap<string, readonly Symbol$1[]>;
       rules?: readonly Rule[];
     }): GridData;
+    toArrayCoordinates(x: number, y: number): Position$1;
     isPositionValid(x: number, y: number): boolean;
     /**
      * Safely get the tile at the given position.
@@ -934,12 +982,20 @@ declare global {
      * @param position The position to start the iteration from. This position is included in the iteration.
      * @param predicate The predicate to test each tile with. The callback is only called for tiles that satisfy this predicate.
      * @param callback The callback to call for each tile that satisfies the predicate. The iteration stops when this callback returns a value that is not undefined.
+     * @param visited A 2D array to keep track of visited tiles. This array is modified by the function.
      * @returns The value returned by the callback that stopped the iteration, or undefined if the iteration completed.
      */
     iterateArea<T>(
       position: Position$1,
       predicate: (tile: TileData) => boolean,
-      callback: (tile: TileData, x: number, y: number) => undefined | T
+      callback: (
+        tile: TileData,
+        x: number,
+        y: number,
+        logicalX: number,
+        logicalY: number
+      ) => undefined | T,
+      visited?: boolean[][]
     ): T | undefined;
     /**
      * Iterate over all tiles in a straight line from the given position in the given direction that satisfy the predicate.
@@ -950,13 +1006,21 @@ declare global {
      * @param direction The direction to iterate in.
      * @param predicate The predicate to test each tile with. The callback is only called for tiles that satisfy this predicate.
      * @param callback The callback to call for each tile that satisfies the predicate. The iteration stops when this callback returns a value that is not undefined.
+     * @param visited A 2D array to keep track of visited tiles. This array is modified by the function.
      * @returns The value returned by the callback that stopped the iteration, or undefined if the iteration completed.
      */
     iterateDirection<T>(
       position: Position$1,
       direction: Direction | Orientation,
       predicate: (tile: TileData) => boolean,
-      callback: (tile: TileData, x: number, y: number) => T | undefined
+      callback: (
+        tile: TileData,
+        x: number,
+        y: number,
+        logicalX: number,
+        logicalY: number
+      ) => T | undefined,
+      visited?: boolean[][]
     ): T | undefined;
     /**
      * Iterate over all tiles in a straight line from the given position in the given direction that satisfy the predicate.
@@ -967,13 +1031,21 @@ declare global {
      * @param direction The direction to iterate in.
      * @param predicate The predicate to test each tile with. The callback is only called for tiles that satisfy this predicate.
      * @param callback The callback to call for each tile that satisfies the predicate. The iteration stops when this callback returns a value that is not undefined.
+     * @param visited A 2D array to keep track of visited tiles. This array is modified by the function.
      * @returns The value returned by the callback that stopped the iteration, or undefined if the iteration completed.
      */
     iterateDirectionAll<T>(
       position: Position$1,
       direction: Direction | Orientation,
       predicate: (tile: TileData) => boolean,
-      callback: (tile: TileData, x: number, y: number) => T | undefined
+      callback: (
+        tile: TileData,
+        x: number,
+        y: number,
+        logicalX: number,
+        logicalY: number
+      ) => T | undefined,
+      visited?: boolean[][]
     ): T | undefined;
     /**
      * Check if every tile in the grid is filled with a color other than gray.
@@ -1125,6 +1197,7 @@ declare global {
     String = 'string',
     Color = 'color',
     Comparison = 'comparison',
+    Wrapping = 'wrapping',
     Direction = 'direction',
     DirectionToggle = 'directionToggle',
     Orientation = 'orientation',
@@ -1174,6 +1247,9 @@ declare global {
   export interface ComparisonConfig extends Config<Comparison> {
     readonly type: ConfigType.Comparison;
   }
+  export interface WrappingConfig extends Config<Wrapping> {
+    readonly type: ConfigType.Wrapping;
+  }
   export interface DirectionConfig extends Config<Direction> {
     readonly type: ConfigType.Direction;
   }
@@ -1217,6 +1293,7 @@ declare global {
     | StringConfig
     | ColorConfig
     | ComparisonConfig
+    | WrappingConfig
     | DirectionConfig
     | DirectionToggleConfig
     | OrientationConfig

package/dist/data/config.d.ts

@@ -1,5 +1,5 @@
 import GridData from './grid.js';
-import { Color, Comparison, Direction, DirectionToggle, Orientation, OrientationToggle, Position } from './primitives.js';
+import { Color, Comparison, Direction, DirectionToggle, Orientation, OrientationToggle, Position, Wrapping } from './primitives.js';
 import { ControlLine } from './rules/musicControlLine.js';
 export declare enum ConfigType {
     Boolean = "boolean",
@@ -9,6 +9,7 @@ export declare enum ConfigType {
     String = "string",
     Color = "color",
     Comparison = "comparison",
+    Wrapping = "wrapping",
     Direction = "direction",
     DirectionToggle = "directionToggle",
     Orientation = "orientation",
@@ -58,6 +59,9 @@ export interface ColorConfig extends Config<Color> {
 export interface ComparisonConfig extends Config<Comparison> {
     readonly type: ConfigType.Comparison;
 }
+export interface WrappingConfig extends Config<Wrapping> {
+    readonly type: ConfigType.Wrapping;
+}
 export interface DirectionConfig extends Config<Direction> {
     readonly type: ConfigType.Direction;
 }
@@ -93,7 +97,7 @@ export interface NullableNoteConfig extends Config<string | null> {
 export interface SolvePathConfig extends Config<Position[]> {
     readonly type: ConfigType.SolvePath;
 }
-export type AnyConfig = BooleanConfig | NullableBooleanConfig | NumberConfig | NullableNumberConfig | StringConfig | ColorConfig | ComparisonConfig | DirectionConfig | DirectionToggleConfig | OrientationConfig | OrientationToggleConfig | TileConfig | GridConfig | NullableGridConfig | IconConfig | ControlLinesConfig | NullableNoteConfig | SolvePathConfig;
+export type AnyConfig = BooleanConfig | NullableBooleanConfig | NumberConfig | NullableNumberConfig | StringConfig | ColorConfig | ComparisonConfig | WrappingConfig | DirectionConfig | DirectionToggleConfig | OrientationConfig | OrientationToggleConfig | TileConfig | GridConfig | NullableGridConfig | IconConfig | ControlLinesConfig | NullableNoteConfig | SolvePathConfig;
 /**
  * Compare two config values for equality, using an appropriate method for the config type.
  *

package/dist/data/config.js

@@ -8,6 +8,7 @@ export var ConfigType;
     ConfigType["String"] = "string";
     ConfigType["Color"] = "color";
     ConfigType["Comparison"] = "comparison";
+    ConfigType["Wrapping"] = "wrapping";
     ConfigType["Direction"] = "direction";
     ConfigType["DirectionToggle"] = "directionToggle";
     ConfigType["Orientation"] = "orientation";

package/dist/data/events/onGetTile.d.ts

@@ -0,0 +1,7 @@
+import Instruction from '../instruction.js';
+import { Position } from '../primitives.js';
+import GridData from '../grid.js';
+export interface GetTileHandler {
+    onGetTile(x: number, y: number, grid: GridData): Position;
+}
+export declare function handlesGetTile<T extends Instruction>(val: T): val is T & GetTileHandler;

package/dist/data/events/onGetTile.js

@@ -0,0 +1,4 @@
+import { isEventHandler } from './eventHelper.js';
+export function handlesGetTile(val) {
+    return isEventHandler(val, 'onGetTile');
+}

package/dist/data/grid.d.ts

@@ -8,6 +8,7 @@ import MusicGridRule from './rules/musicGridRule.js';
 import CompletePatternRule from './rules/completePatternRule.js';
 import UndercluedRule from './rules/undercluedRule.js';
 import GridZones from './gridZones.js';
+import WrapAroundRule from './rules/wrapAroundRule.js';
 export declare const NEIGHBOR_OFFSETS: Position[];
 export default class GridData {
     readonly width: number;
@@ -20,6 +21,7 @@ export default class GridData {
     readonly musicGrid: CachedAccess<MusicGridRule | undefined>;
     readonly completePattern: CachedAccess<CompletePatternRule | undefined>;
     readonly underclued: CachedAccess<UndercluedRule | undefined>;
+    readonly wrapAround: CachedAccess<WrapAroundRule | undefined>;
     /**
      * Create a new grid with tiles, connections, symbols and rules.
      *
@@ -86,6 +88,7 @@ export default class GridData {
         symbols?: ReadonlyMap<string, readonly Symbol[]>;
         rules?: readonly Rule[];
     }): GridData;
+    toArrayCoordinates(x: number, y: number): Position;
     isPositionValid(x: number, y: number): boolean;
     /**
      * Safely get the tile at the given position.
@@ -255,9 +258,10 @@ export default class GridData {
      * @param position The position to start the iteration from. This position is included in the iteration.
      * @param predicate The predicate to test each tile with. The callback is only called for tiles that satisfy this predicate.
      * @param callback The callback to call for each tile that satisfies the predicate. The iteration stops when this callback returns a value that is not undefined.
+     * @param visited A 2D array to keep track of visited tiles. This array is modified by the function.
      * @returns The value returned by the callback that stopped the iteration, or undefined if the iteration completed.
      */
-    iterateArea<T>(position: Position, predicate: (tile: TileData) => boolean, callback: (tile: TileData, x: number, y: number) => undefined | T): T | undefined;
+    iterateArea<T>(position: Position, predicate: (tile: TileData) => boolean, callback: (tile: TileData, x: number, y: number, logicalX: number, logicalY: number) => undefined | T, visited?: boolean[][]): T | undefined;
     /**
      * Iterate over all tiles in a straight line from the given position in the given direction that satisfy the predicate.
      * The iteration stops when the callback returns a value that is not undefined.
@@ -267,9 +271,10 @@ export default class GridData {
      * @param direction The direction to iterate in.
      * @param predicate The predicate to test each tile with. The callback is only called for tiles that satisfy this predicate.
      * @param callback The callback to call for each tile that satisfies the predicate. The iteration stops when this callback returns a value that is not undefined.
+     * @param visited A 2D array to keep track of visited tiles. This array is modified by the function.
      * @returns The value returned by the callback that stopped the iteration, or undefined if the iteration completed.
      */
-    iterateDirection<T>(position: Position, direction: Direction | Orientation, predicate: (tile: TileData) => boolean, callback: (tile: TileData, x: number, y: number) => T | undefined): T | undefined;
+    iterateDirection<T>(position: Position, direction: Direction | Orientation, predicate: (tile: TileData) => boolean, callback: (tile: TileData, x: number, y: number, logicalX: number, logicalY: number) => T | undefined, visited?: boolean[][]): T | undefined;
     /**
      * Iterate over all tiles in a straight line from the given position in the given direction that satisfy the predicate.
      * The iteration stops when the callback returns a value that is not undefined.
@@ -279,9 +284,10 @@ export default class GridData {
      * @param direction The direction to iterate in.
      * @param predicate The predicate to test each tile with. The callback is only called for tiles that satisfy this predicate.
      * @param callback The callback to call for each tile that satisfies the predicate. The iteration stops when this callback returns a value that is not undefined.
+     * @param visited A 2D array to keep track of visited tiles. This array is modified by the function.
      * @returns The value returned by the callback that stopped the iteration, or undefined if the iteration completed.
      */
-    iterateDirectionAll<T>(position: Position, direction: Direction | Orientation, predicate: (tile: TileData) => boolean, callback: (tile: TileData, x: number, y: number) => T | undefined): T | undefined;
+    iterateDirectionAll<T>(position: Position, direction: Direction | Orientation, predicate: (tile: TileData) => boolean, callback: (tile: TileData, x: number, y: number, logicalX: number, logicalY: number) => T | undefined, visited?: boolean[][]): T | undefined;
     /**
      * Check if every tile in the grid is filled with a color other than gray.
      *

package/dist/data/grid.js

@@ -88,6 +88,12 @@ export default class GridData {
             writable: true,
             value: CachedAccess.of(() => this.findRule(rule => rule.id === MajorRule.Underclued))
         });
+        Object.defineProperty(this, "wrapAround", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: CachedAccess.of(() => this.findRule(rule => rule.id === MajorRule.WrapAround))
+        });
         this.width = width;
         this.height = height;
         this.tiles = tiles ?? array(width, height, () => TileData.empty());
@@ -141,7 +147,30 @@ export default class GridData {
     fastCopyWith({ width, height, tiles, connections, zones, symbols, rules, }) {
         return new GridData(width ?? this.width, height ?? this.height, tiles ?? this.tiles, connections ?? this.connections, zones ?? this.zones, symbols ?? this.symbols, rules ?? this.rules);
     }
+    toArrayCoordinates(x, y) {
+        // // This is the preferred way to compute tile coordinates, but for performance reasons we will just access the
+        // // wrap-around rule directly.
+        // this.rules.forEach(rule => {
+        //   if (handlesGetTile(rule)) {
+        //     ({ x, y } = rule.onGetTile(x, y));
+        //   }
+        // });
+        // this.symbols.forEach(list =>
+        //   list.forEach(symbol => {
+        //     if (handlesGetTile(symbol)) {
+        //       ({ x, y } = symbol.onGetTile(x, y));
+        //     }
+        //   })
+        // );
+        if (this.wrapAround.value) {
+            return this.wrapAround.value.onGetTile(x, y, this);
+        }
+        else {
+            return { x, y };
+        }
+    }
     isPositionValid(x, y) {
+        ({ x, y } = this.toArrayCoordinates(x, y));
         return x >= 0 && x < this.width && y >= 0 && y < this.height;
     }
     /**
@@ -151,7 +180,8 @@ export default class GridData {
      * @returns The tile at the given position, or a non-existent tile if the position is invalid.
      */
     getTile(x, y) {
-        if (!this.isPositionValid(x, y))
+        ({ x, y } = this.toArrayCoordinates(x, y));
+        if (x < 0 || x >= this.width || y < 0 || y >= this.height)
             return TileData.doesNotExist();
         return this.tiles[y][x];
     }
@@ -166,6 +196,7 @@ export default class GridData {
      * @returns The new tile array with updated tiles.
      */
     setTile(x, y, tile) {
+        ({ x, y } = this.toArrayCoordinates(x, y));
         if (x < 0 || x >= this.width || y < 0 || y >= this.height) {
             return this.tiles;
         }
@@ -587,22 +618,23 @@ export default class GridData {
      * @param position The position to start the iteration from. This position is included in the iteration.
      * @param predicate The predicate to test each tile with. The callback is only called for tiles that satisfy this predicate.
      * @param callback The callback to call for each tile that satisfies the predicate. The iteration stops when this callback returns a value that is not undefined.
+     * @param visited A 2D array to keep track of visited tiles. This array is modified by the function.
      * @returns The value returned by the callback that stopped the iteration, or undefined if the iteration completed.
      */
-    iterateArea(position, predicate, callback) {
+    iterateArea(position, predicate, callback, visited = array(this.width, this.height, () => false)) {
         const tile = this.getTile(position.x, position.y);
         if (!tile.exists || !predicate(tile)) {
             return;
         }
-        const visited = array(this.width, this.height, () => false);
         const stack = [position];
         while (stack.length > 0) {
             const { x, y } = stack.pop();
-            if (visited[y][x]) {
+            const { x: arrX, y: arrY } = this.toArrayCoordinates(x, y);
+            if (visited[arrY][arrX]) {
                 continue;
             }
-            visited[y][x] = true;
-            const ret = callback(this.getTile(x, y), x, y);
+            visited[arrY][arrX] = true;
+            const ret = callback(this.getTile(x, y), arrX, arrY, x, y);
             if (ret !== undefined)
                 return ret;
             for (const offset of NEIGHBOR_OFFSETS) {
@@ -624,10 +656,11 @@ export default class GridData {
      * @param direction The direction to iterate in.
      * @param predicate The predicate to test each tile with. The callback is only called for tiles that satisfy this predicate.
      * @param callback The callback to call for each tile that satisfies the predicate. The iteration stops when this callback returns a value that is not undefined.
+     * @param visited A 2D array to keep track of visited tiles. This array is modified by the function.
      * @returns The value returned by the callback that stopped the iteration, or undefined if the iteration completed.
      */
-    iterateDirection(position, direction, predicate, callback) {
-        return this.iterateDirectionAll(position, direction, tile => tile.exists && predicate(tile), callback);
+    iterateDirection(position, direction, predicate, callback, visited = array(this.width, this.height, () => false)) {
+        return this.iterateDirectionAll(position, direction, tile => tile.exists && predicate(tile), callback, visited);
     }
     /**
      * Iterate over all tiles in a straight line from the given position in the given direction that satisfy the predicate.
@@ -638,16 +671,22 @@ export default class GridData {
      * @param direction The direction to iterate in.
      * @param predicate The predicate to test each tile with. The callback is only called for tiles that satisfy this predicate.
      * @param callback The callback to call for each tile that satisfies the predicate. The iteration stops when this callback returns a value that is not undefined.
+     * @param visited A 2D array to keep track of visited tiles. This array is modified by the function.
      * @returns The value returned by the callback that stopped the iteration, or undefined if the iteration completed.
      */
-    iterateDirectionAll(position, direction, predicate, callback) {
+    iterateDirectionAll(position, direction, predicate, callback, visited = array(this.width, this.height, () => false)) {
         let current = position;
         while (this.isPositionValid(current.x, current.y)) {
+            const arrPos = this.toArrayCoordinates(current.x, current.y);
+            if (visited[arrPos.y][arrPos.x]) {
+                break;
+            }
+            visited[arrPos.y][arrPos.x] = true;
             const tile = this.getTile(current.x, current.y);
             if (!predicate(tile)) {
                 break;
             }
-            const ret = callback(tile, current.x, current.y);
+            const ret = callback(tile, arrPos.x, arrPos.y, current.x, current.y);
             if (ret !== undefined)
                 return ret;
             current = move(current, direction);

package/dist/data/primitives.d.ts

@@ -14,7 +14,8 @@ export interface Edge {
 export declare enum MajorRule {
     MusicGrid = "music",
     CompletePattern = "complete_pattern",
-    Underclued = "underclued"
+    Underclued = "underclued",
+    WrapAround = "wrap_around"
 }
 export declare enum State {
     /**
@@ -63,6 +64,12 @@ export declare enum Comparison {
     AtMost = "le"
 }
 export declare const COMPARISONS: readonly Comparison[];
+export declare enum Wrapping {
+    None = "none",
+    Wrap = "wrap",
+    WrapReverse = "wrap-reverse"
+}
+export declare const WRAPPINGS: readonly Wrapping[];
 export declare enum Direction {
     Up = "up",
     Down = "down",

package/dist/data/primitives.js

@@ -6,6 +6,7 @@ export var MajorRule;
     MajorRule["MusicGrid"] = "music";
     MajorRule["CompletePattern"] = "complete_pattern";
     MajorRule["Underclued"] = "underclued";
+    MajorRule["WrapAround"] = "wrap_around";
 })(MajorRule || (MajorRule = {}));
 export var State;
 (function (State) {
@@ -50,6 +51,17 @@ export const COMPARISONS = [
     Comparison.AtLeast,
     Comparison.AtMost,
 ];
+export var Wrapping;
+(function (Wrapping) {
+    Wrapping["None"] = "none";
+    Wrapping["Wrap"] = "wrap";
+    Wrapping["WrapReverse"] = "wrap-reverse";
+})(Wrapping || (Wrapping = {}));
+export const WRAPPINGS = [
+    Wrapping.None,
+    Wrapping.Wrap,
+    Wrapping.WrapReverse,
+];
 export var Direction;
 (function (Direction) {
     Direction["Up"] = "up";

package/dist/data/rules/banPatternRule.js

@@ -71,8 +71,8 @@ class BanPatternRule extends Rule {
     }
     validateGrid(grid) {
         for (const pattern of this.cache) {
-            for (let y = 0; y <= grid.height - pattern.height; y++) {
-                for (let x = 0; x <= grid.width - pattern.width; x++) {
+            for (let y = 0; y <= grid.height - 1; y++) {
+                for (let x = 0; x <= grid.width - 1; x++) {
                     let match = true;
                     for (const tile of pattern.elements) {
                         const t = grid.getTile(x + tile.x, y + tile.y);
@@ -84,10 +84,7 @@ class BanPatternRule extends Rule {
                     if (match) {
                         return {
                             state: State.Error,
-                            positions: pattern.elements.map(tile => ({
-                                x: x + tile.x,
-                                y: y + tile.y,
-                            })),
+                            positions: pattern.elements.map(tile => grid.toArrayCoordinates(x + tile.x, y + tile.y)),
                         };
                     }
                 }

package/dist/data/rules/cellCountPerZoneRule.js

@@ -58,7 +58,8 @@ class CellCountPerZoneRule extends Rule {
             };
             const stack = [seed];
             while (stack.length > 0) {
-                const { x, y } = stack.pop();
+                let { x, y } = stack.pop();
+                ({ x, y } = grid.toArrayCoordinates(x, y));
                 if (visited[y][x])
                     continue;
                 visited[y][x] = true;
@@ -71,12 +72,13 @@ class CellCountPerZoneRule extends Rule {
                     complete = false;
                 }
                 for (const offset of NEIGHBOR_OFFSETS) {
-                    const next = { x: x + offset.x, y: y + offset.y };
-                    if (!grid.zones.edges.some(e => (e.x1 === x &&
-                        e.y1 === y &&
-                        e.x2 === next.x &&
-                        e.y2 === next.y) ||
-                        (e.x1 === next.x && e.y1 === next.y && e.x2 === x && e.y2 === y))) {
+                    const next = grid.toArrayCoordinates(x + offset.x, y + offset.y);
+                    if (!grid.zones.edges.some(e => {
+                        const { x: x1, y: y1 } = grid.toArrayCoordinates(e.x1, e.y1);
+                        const { x: x2, y: y2 } = grid.toArrayCoordinates(e.x2, e.y2);
+                        return ((x1 === x && y1 === y && x2 === next.x && y2 === next.y) ||
+                            (x2 === x && y2 === y && x1 === next.x && y1 === next.y));
+                    })) {
                         const nextTile = grid.getTile(next.x, next.y);
                         if (nextTile.exists) {
                             stack.push(next);

package/dist/data/rules/musicGridRule.d.ts

@@ -25,7 +25,7 @@ export default class MusicGridRule extends Rule implements GridChangeHandler, Se
     get configs(): readonly AnyConfig[] | null;
     createExampleGrid(): GridData;
     get searchVariants(): SearchVariant[];
-    validateGrid(_grid: GridData): RuleState;
+    validateGrid(grid: GridData): RuleState;
     onSetGrid(_oldGrid: GridData, newGrid: GridData, _solution: GridData | null): GridData;
     onGridChange(newGrid: GridData): this;
     onGridResize(_grid: GridData, mode: 'insert' | 'remove', direction: 'row' | 'column', index: number): this | null;

package/dist/data/rules/musicGridRule.js

@@ -61,8 +61,13 @@ class MusicGridRule extends Rule {
     get searchVariants() {
         return MusicGridRule.SEARCH_VARIANTS;
     }
-    validateGrid(_grid) {
-        return { state: State.Incomplete };
+    validateGrid(grid) {
+        if (grid.getTileCount(true, false, Color.Gray) > 0) {
+            return { state: State.Incomplete };
+        }
+        else {
+            return { state: State.Satisfied };
+        }
     }
     onSetGrid(_oldGrid, newGrid, _solution) {
         if (newGrid.getTileCount(true, undefined, Color.Gray) === 0)

package/dist/data/rules/regionShapeRule.js

@@ -30,9 +30,9 @@ export default class RegionShapeRule extends Rule {
             if (!seed)
                 break;
             const positions = [];
-            grid.iterateArea(seed, tile => tile.color === this.color, (_, x, y) => {
+            grid.iterateArea(seed, tile => tile.color === this.color, (_, x, y, logX, logY) => {
                 visited[y][x] = true;
-                positions.push({ x, y });
+                positions.push({ x: logX, y: logY });
             });
             const incomplete = grid.iterateArea(seed, tile => tile.color === this.color || tile.color === Color.Gray, tile => {
                 if (tile.color === Color.Gray)
@@ -46,7 +46,11 @@ export default class RegionShapeRule extends Rule {
                 existing.count++;
             }
             else {
-                regions.push({ positions, shape, count: 1 });
+                regions.push({
+                    positions: positions.map(pos => grid.toArrayCoordinates(pos.x, pos.y)),
+                    shape,
+                    count: 1,
+                });
             }
         }
         return { regions, complete };

package/dist/data/rules/rules.gen.d.ts

@@ -15,3 +15,4 @@ export { instance as SameShapeRule } from './sameShapeRule.js';
 export { instance as SymbolsPerRegionRule } from './symbolsPerRegionRule.js';
 export { instance as UndercluedRule } from './undercluedRule.js';
 export { instance as UniqueShapeRule } from './uniqueShapeRule.js';
+export { instance as WrapAroundRule } from './wrapAroundRule.js';

package/dist/data/rules/rules.gen.js

@@ -19,3 +19,4 @@ export { instance as SameShapeRule } from './sameShapeRule.js';
 export { instance as SymbolsPerRegionRule } from './symbolsPerRegionRule.js';
 export { instance as UndercluedRule } from './undercluedRule.js';
 export { instance as UniqueShapeRule } from './uniqueShapeRule.js';
+export { instance as WrapAroundRule } from './wrapAroundRule.js';

package/dist/data/rules/wrapAroundRule.d.ts

@@ -0,0 +1,36 @@
+import { AnyConfig } from '../config.js';
+import { GetTileHandler } from '../events/onGetTile.js';
+import GridData from '../grid.js';
+import { Position, RuleState, Wrapping } from '../primitives.js';
+import Rule, { SearchVariant } from './rule.js';
+export default class WrapAroundRule extends Rule implements GetTileHandler {
+    readonly horizontal: Wrapping;
+    readonly vertical: Wrapping;
+    private static readonly EXAMPLE_GRID_NONE;
+    private static readonly EXAMPLE_GRID_HORIZONTAL;
+    private static readonly EXAMPLE_GRID_HORIZONTAL_REVERSE;
+    private static readonly EXAMPLE_GRID_VERTICAL;
+    private static readonly EXAMPLE_GRID_VERTICAL_REVERSE;
+    private static readonly SEARCH_VARIANTS;
+    private static readonly CONFIGS;
+    /**
+     * **The left and right edges are connected (in reverse)**
+     *
+     * @param horizontal - The horizontal wrapping.
+     * @param vertical - The vertical wrapping.
+     */
+    constructor(horizontal: Wrapping, vertical: Wrapping);
+    onGetTile(x: number, y: number, grid: GridData): Position;
+    get id(): string;
+    get explanation(): string;
+    createExampleGrid(): GridData;
+    get configs(): readonly AnyConfig[] | null;
+    get searchVariants(): SearchVariant[];
+    validateGrid(grid: GridData): RuleState;
+    copyWith({ horizontal, vertical, }: {
+        horizontal?: Wrapping;
+        vertical?: Wrapping;
+    }): this;
+    get isSingleton(): boolean;
+}
+export declare const instance: WrapAroundRule;

package/dist/data/rules/wrapAroundRule.js

@@ -0,0 +1,205 @@
+import { ConfigType } from '../config.js';
+import { array } from '../dataHelper.js';
+import GridData from '../grid.js';
+import { Color, MajorRule, State, Wrapping, } from '../primitives.js';
+import LetterSymbol from '../symbols/letterSymbol.js';
+import Rule from './rule.js';
+class WrapAroundRule extends Rule {
+    /**
+     * **The left and right edges are connected (in reverse)**
+     *
+     * @param horizontal - The horizontal wrapping.
+     * @param vertical - The vertical wrapping.
+     */
+    constructor(horizontal, vertical) {
+        super();
+        Object.defineProperty(this, "horizontal", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: horizontal
+        });
+        Object.defineProperty(this, "vertical", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: vertical
+        });
+        this.horizontal = horizontal;
+        this.vertical = vertical;
+    }
+    onGetTile(x, y, grid) {
+        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 && idx % 2 === 1) {
+                y = grid.height - 1 - y;
+            }
+        }
+        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 && idx % 2 === 1) {
+                x = grid.width - 1 - x;
+            }
+        }
+        return { x, y };
+    }
+    get id() {
+        return MajorRule.WrapAround;
+    }
+    get explanation() {
+        if (this.horizontal === Wrapping.None && this.vertical === Wrapping.None) {
+            return `No edges are connected.`;
+        }
+        else if (this.horizontal === Wrapping.None) {
+            return `The top and bottom edges are connected${this.vertical === Wrapping.WrapReverse ? ' in reverse' : ''}.`;
+        }
+        else if (this.vertical === Wrapping.None) {
+            return `The left and right edges are connected${this.horizontal === Wrapping.WrapReverse ? ' in reverse' : ''}.`;
+        }
+        else if (this.horizontal === Wrapping.Wrap &&
+            this.vertical === Wrapping.Wrap) {
+            return `All four edges are connected.`;
+        }
+        else if (this.horizontal === Wrapping.Wrap) {
+            return `All four edges are connected, with the top and bottom edges in reverse.`;
+        }
+        else if (this.vertical === Wrapping.Wrap) {
+            return `All four edges are connected, with the left and right edges in reverse.`;
+        }
+        else {
+            return `All four edges are connected in reverse.`;
+        }
+    }
+    createExampleGrid() {
+        const horizontal = this.horizontal === Wrapping.Wrap
+            ? WrapAroundRule.EXAMPLE_GRID_HORIZONTAL
+            : this.horizontal === Wrapping.WrapReverse
+                ? WrapAroundRule.EXAMPLE_GRID_HORIZONTAL_REVERSE
+                : WrapAroundRule.EXAMPLE_GRID_NONE;
+        const vertical = this.vertical === Wrapping.Wrap
+            ? WrapAroundRule.EXAMPLE_GRID_VERTICAL
+            : this.vertical === Wrapping.WrapReverse
+                ? WrapAroundRule.EXAMPLE_GRID_VERTICAL_REVERSE
+                : WrapAroundRule.EXAMPLE_GRID_NONE;
+        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;
+    }
+}
+Object.defineProperty(WrapAroundRule, "EXAMPLE_GRID_NONE", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze(GridData.create(['wwwww', 'wwwww', 'wwwww', 'wwwww', 'wwwww']))
+});
+Object.defineProperty(WrapAroundRule, "EXAMPLE_GRID_HORIZONTAL", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze(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')))
+});
+Object.defineProperty(WrapAroundRule, "EXAMPLE_GRID_HORIZONTAL_REVERSE", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze(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')))
+});
+Object.defineProperty(WrapAroundRule, "EXAMPLE_GRID_VERTICAL", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze(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')))
+});
+Object.defineProperty(WrapAroundRule, "EXAMPLE_GRID_VERTICAL_REVERSE", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze(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')))
+});
+Object.defineProperty(WrapAroundRule, "SEARCH_VARIANTS", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: [
+        new WrapAroundRule(Wrapping.Wrap, Wrapping.None).searchVariant(),
+        new WrapAroundRule(Wrapping.None, Wrapping.Wrap).searchVariant(),
+        new WrapAroundRule(Wrapping.Wrap, Wrapping.Wrap).searchVariant(),
+    ]
+});
+Object.defineProperty(WrapAroundRule, "CONFIGS", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: 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,
+        },
+    ])
+});
+export default WrapAroundRule;
+export const instance = new WrapAroundRule(Wrapping.Wrap, Wrapping.Wrap);

package/dist/data/serializer/serializer_v0.js

@@ -103,6 +103,7 @@ export default class SerializerV0 extends SerializerBase {
             case ConfigType.Number:
             case ConfigType.Color:
             case ConfigType.Comparison:
+            case ConfigType.Wrapping:
             case ConfigType.Direction:
             case ConfigType.Orientation:
                 return (config.field +
@@ -190,6 +191,8 @@ export default class SerializerV0 extends SerializerBase {
                 return [config.field, value];
             case ConfigType.Comparison:
                 return [config.field, value];
+            case ConfigType.Wrapping:
+                return [config.field, value];
             case ConfigType.Direction:
                 return [config.field, value];
             case ConfigType.DirectionToggle: {

package/dist/data/solver/universal/universalWorker.js

@@ -44,6 +44,10 @@ function backtrack(grid, rawTiles, submitSolution) {
     return false;
 }
 function solveNormal(input, submitSolution) {
+    const isValid = validateGrid(input, null);
+    if (isValid.final === State.Error) {
+        return;
+    }
     // Call backtrack
     backtrack(input, gridToRawTiles(input), rawTiles => submitSolution(rawTiles ? rawTilesToGrid(rawTiles, input) : null));
 }

package/dist/data/symbols/directionLinkerSymbol.js

@@ -65,11 +65,8 @@ class DirectionLinkerSymbol extends Symbol {
     createExampleGrid() {
         return DirectionLinkerSymbol.EXAMPLE_GRID;
     }
-    deltaCoordinate(c, direction) {
-        return {
-            x: c.x + DirectionLinkerSymbol.directionDeltas[direction].dx,
-            y: c.y + DirectionLinkerSymbol.directionDeltas[direction].dy,
-        };
+    deltaCoordinate(c, direction, grid) {
+        return grid.toArrayCoordinates(c.x + DirectionLinkerSymbol.directionDeltas[direction].dx, c.y + DirectionLinkerSymbol.directionDeltas[direction].dy);
     }
     validateSymbol(grid) {
         // A turtle is an object which have 2 coordinates
@@ -115,8 +112,8 @@ class DirectionLinkerSymbol extends Symbol {
                 const directions = Object.keys(this.linkedDirections);
                 for (const direction of directions) {
                     const newTurtle = {
-                        pos1: this.deltaCoordinate(pos1, direction),
-                        pos2: this.deltaCoordinate(pos2, this.linkedDirections[direction]),
+                        pos1: this.deltaCoordinate(pos1, direction, grid),
+                        pos2: this.deltaCoordinate(pos2, this.linkedDirections[direction], grid),
                         color1: baseColor1,
                         color2: baseColor2,
                     };

package/dist/data/symbols/viewpointSymbol.js

@@ -1,6 +1,6 @@
 import { ConfigType } from '../config.js';
 import GridData from '../grid.js';
-import { move } from '../dataHelper.js';
+import { array, move } from '../dataHelper.js';
 import { Color, DIRECTIONS } from '../primitives.js';
 import NumberSymbol from './numberSymbol.js';
 class ViewpointSymbol extends NumberSymbol {
@@ -31,6 +31,7 @@ class ViewpointSymbol extends NumberSymbol {
     countForColor(grid, color, pos) {
         let minSize = 1;
         let maxSize = 1;
+        const visited = array(grid.width, grid.height, (x, y) => x === pos.x && y === pos.y);
         for (const direction of DIRECTIONS) {
             let continuous = true;
             grid.iterateDirection(move(pos, direction), direction, tile => tile.color === color || tile.color === Color.Gray, tile => {
@@ -42,7 +43,7 @@ class ViewpointSymbol extends NumberSymbol {
                     if (continuous)
                         minSize++;
                 }
-            });
+            }, visited);
         }
         return { completed: minSize, possible: maxSize };
     }

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import Configurable from './data/configurable.js';
 import { CachedAccess, allEqual, array, directionToRotation, escape, isSameEdge, maxBy, minBy, move, orientationToRotation, resize, unescape } from './data/dataHelper.js';
 import { isEventHandler } from './data/events/eventHelper.js';
 import { handlesFinalValidation } from './data/events/onFinalValidation.js';
+import { handlesGetTile } from './data/events/onGetTile.js';
 import { handlesGridChange } from './data/events/onGridChange.js';
 import { handlesGridResize } from './data/events/onGridResize.js';
 import { handlesSetGrid, invokeSetGrid } from './data/events/onSetGrid.js';
@@ -12,7 +13,7 @@ import GridData, { NEIGHBOR_OFFSETS } from './data/grid.js';
 import GridConnections from './data/gridConnections.js';
 import GridZones from './data/gridZones.js';
 import Instruction from './data/instruction.js';
-import { COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, directionToggle, orientationToggle } from './data/primitives.js';
+import { COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, WRAPPINGS, Wrapping, directionToggle, orientationToggle } from './data/primitives.js';
 import { MetadataSchema, PuzzleSchema } from './data/puzzle.js';
 import BanPatternRule from './data/rules/banPatternRule.js';
 import CellCountPerZoneRule from './data/rules/cellCountPerZoneRule.js';
@@ -35,6 +36,7 @@ import SameShapeRule from './data/rules/sameShapeRule.js';
 import SymbolsPerRegionRule from './data/rules/symbolsPerRegionRule.js';
 import UndercluedRule from './data/rules/undercluedRule.js';
 import UniqueShapeRule from './data/rules/uniqueShapeRule.js';
+import WrapAroundRule from './data/rules/wrapAroundRule.js';
 import { Serializer } from './data/serializer/allSerializers.js';
 import { Compressor } from './data/serializer/compressor/allCompressors.js';
 import CompressorBase from './data/serializer/compressor/compressorBase.js';
@@ -100,4 +102,4 @@ import ViewpointSymbol from './data/symbols/viewpointSymbol.js';
 import TileData from './data/tile.js';
 import TileConnections from './data/tileConnections.js';
 import validateGrid, { aggregateState, applyFinalOverrides } from './data/validate.js';
-export { ConfigType, configEquals, Configurable, CachedAccess, allEqual, array, directionToRotation, escape, isSameEdge, maxBy, minBy, move, orientationToRotation, resize, unescape, isEventHandler, handlesFinalValidation, handlesGridChange, handlesGridResize, handlesSetGrid, invokeSetGrid, handlesSymbolDisplay, handlesSymbolValidation, GridData, NEIGHBOR_OFFSETS, GridConnections, GridZones, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, directionToggle, orientationToggle, MetadataSchema, PuzzleSchema, BanPatternRule, CellCountPerZoneRule, CellCountRule, CompletePatternRule, ConnectAllRule, CustomRule, ForesightRule, allRules, LyingSymbolRule, ControlLine, Row, MusicGridRule, MysteryRule, OffByXRule, PerfectionRule, RegionAreaRule, RegionShapeRule, Rule, SameShapeRule, SymbolsPerRegionRule, UndercluedRule, UniqueShapeRule, Serializer, Compressor, CompressorBase, DeflateCompressor, GzipCompressor, StreamCompressor, SerializerBase, SerializerV0, getShapeVariants, normalizeShape, positionsToShape, shapeEquals, tilesToShape, allSolvers, BacktrackSolver, BTModule, BTGridData, BTTile, IntArray2D, colorToBTTile, createOneTileResult, getOppositeColor, BanPatternBTModule, CellCountBTModule, ConnectAllBTModule, RegionAreaBTModule, RegionShapeBTModule, SameShapeBTModule, SymbolsPerRegionBTModule, UniqueShapeBTModule, AreaNumberBTModule, DartBTModule, DirectionLinkerBTModule, GalaxyBTModule, LetterBTModule, LotusBTModule, MinesweeperBTModule, MyopiaBTModule, ViewpointBTModule, EventIteratingSolver, Solver, UniversalSolver, AreaNumberModule, CellCountModule, ConnectAllModule, DartModule, allZ3Modules, LetterModule, MyopiaModule, RegionAreaModule, ViewpointModule, Z3Module, convertDirection, Z3Solver, Z3SolverContext, AreaNumberSymbol, CustomIconSymbol, CustomSymbol, CustomTextSymbol, DartSymbol, DirectionLinkerSymbol, GalaxySymbol, HiddenSymbol, allSymbols, LetterSymbol, LotusSymbol, MinesweeperSymbol, MultiEntrySymbol, MyopiaSymbol, NumberSymbol, Symbol, ViewpointSymbol, TileData, TileConnections, validateGrid, aggregateState, applyFinalOverrides, };
+export { ConfigType, configEquals, Configurable, CachedAccess, allEqual, array, directionToRotation, escape, isSameEdge, maxBy, minBy, move, orientationToRotation, resize, unescape, isEventHandler, handlesFinalValidation, handlesGetTile, handlesGridChange, handlesGridResize, handlesSetGrid, invokeSetGrid, handlesSymbolDisplay, handlesSymbolValidation, GridData, NEIGHBOR_OFFSETS, GridConnections, GridZones, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, WRAPPINGS, Wrapping, directionToggle, orientationToggle, MetadataSchema, PuzzleSchema, BanPatternRule, CellCountPerZoneRule, CellCountRule, CompletePatternRule, ConnectAllRule, CustomRule, ForesightRule, allRules, LyingSymbolRule, ControlLine, Row, MusicGridRule, MysteryRule, OffByXRule, PerfectionRule, RegionAreaRule, RegionShapeRule, Rule, SameShapeRule, SymbolsPerRegionRule, UndercluedRule, UniqueShapeRule, WrapAroundRule, Serializer, Compressor, CompressorBase, DeflateCompressor, GzipCompressor, StreamCompressor, SerializerBase, SerializerV0, getShapeVariants, normalizeShape, positionsToShape, shapeEquals, tilesToShape, allSolvers, BacktrackSolver, BTModule, BTGridData, BTTile, IntArray2D, colorToBTTile, createOneTileResult, getOppositeColor, BanPatternBTModule, CellCountBTModule, ConnectAllBTModule, RegionAreaBTModule, RegionShapeBTModule, SameShapeBTModule, SymbolsPerRegionBTModule, UniqueShapeBTModule, AreaNumberBTModule, DartBTModule, DirectionLinkerBTModule, GalaxyBTModule, LetterBTModule, LotusBTModule, MinesweeperBTModule, MyopiaBTModule, ViewpointBTModule, EventIteratingSolver, Solver, UniversalSolver, AreaNumberModule, CellCountModule, ConnectAllModule, DartModule, allZ3Modules, LetterModule, MyopiaModule, RegionAreaModule, ViewpointModule, Z3Module, convertDirection, Z3Solver, Z3SolverContext, AreaNumberSymbol, CustomIconSymbol, CustomSymbol, CustomTextSymbol, DartSymbol, DirectionLinkerSymbol, GalaxySymbol, HiddenSymbol, allSymbols, LetterSymbol, LotusSymbol, MinesweeperSymbol, MultiEntrySymbol, MyopiaSymbol, NumberSymbol, Symbol, ViewpointSymbol, TileData, TileConnections, validateGrid, aggregateState, applyFinalOverrides, };

package/dist/index.js

@@ -6,6 +6,7 @@ import Configurable from './data/configurable.js';
 import { CachedAccess, allEqual, array, directionToRotation, escape, isSameEdge, maxBy, minBy, move, orientationToRotation, resize, unescape } from './data/dataHelper.js';
 import { isEventHandler } from './data/events/eventHelper.js';
 import { handlesFinalValidation } from './data/events/onFinalValidation.js';
+import { handlesGetTile } from './data/events/onGetTile.js';
 import { handlesGridChange } from './data/events/onGridChange.js';
 import { handlesGridResize } from './data/events/onGridResize.js';
 import { handlesSetGrid, invokeSetGrid } from './data/events/onSetGrid.js';
@@ -15,7 +16,7 @@ import GridData, { NEIGHBOR_OFFSETS } from './data/grid.js';
 import GridConnections from './data/gridConnections.js';
 import GridZones from './data/gridZones.js';
 import Instruction from './data/instruction.js';
-import { COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, directionToggle, orientationToggle } from './data/primitives.js';
+import { COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, WRAPPINGS, Wrapping, directionToggle, orientationToggle } from './data/primitives.js';
 import { MetadataSchema, PuzzleSchema } from './data/puzzle.js';
 import BanPatternRule from './data/rules/banPatternRule.js';
 import CellCountPerZoneRule from './data/rules/cellCountPerZoneRule.js';
@@ -38,6 +39,7 @@ import SameShapeRule from './data/rules/sameShapeRule.js';
 import SymbolsPerRegionRule from './data/rules/symbolsPerRegionRule.js';
 import UndercluedRule from './data/rules/undercluedRule.js';
 import UniqueShapeRule from './data/rules/uniqueShapeRule.js';
+import WrapAroundRule from './data/rules/wrapAroundRule.js';
 import { Serializer } from './data/serializer/allSerializers.js';
 import { Compressor } from './data/serializer/compressor/allCompressors.js';
 import CompressorBase from './data/serializer/compressor/compressorBase.js';
@@ -103,4 +105,4 @@ import ViewpointSymbol from './data/symbols/viewpointSymbol.js';
 import TileData from './data/tile.js';
 import TileConnections from './data/tileConnections.js';
 import validateGrid, { aggregateState, applyFinalOverrides } from './data/validate.js';
-export { ConfigType, configEquals, Configurable, CachedAccess, allEqual, array, directionToRotation, escape, isSameEdge, maxBy, minBy, move, orientationToRotation, resize, unescape, isEventHandler, handlesFinalValidation, handlesGridChange, handlesGridResize, handlesSetGrid, invokeSetGrid, handlesSymbolDisplay, handlesSymbolValidation, GridData, NEIGHBOR_OFFSETS, GridConnections, GridZones, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, directionToggle, orientationToggle, MetadataSchema, PuzzleSchema, BanPatternRule, CellCountPerZoneRule, CellCountRule, CompletePatternRule, ConnectAllRule, CustomRule, ForesightRule, allRules, LyingSymbolRule, ControlLine, Row, MusicGridRule, MysteryRule, OffByXRule, PerfectionRule, RegionAreaRule, RegionShapeRule, Rule, SameShapeRule, SymbolsPerRegionRule, UndercluedRule, UniqueShapeRule, Serializer, Compressor, CompressorBase, DeflateCompressor, GzipCompressor, StreamCompressor, SerializerBase, SerializerV0, getShapeVariants, normalizeShape, positionsToShape, shapeEquals, tilesToShape, allSolvers, BacktrackSolver, BTModule, BTGridData, BTTile, IntArray2D, colorToBTTile, createOneTileResult, getOppositeColor, BanPatternBTModule, CellCountBTModule, ConnectAllBTModule, RegionAreaBTModule, RegionShapeBTModule, SameShapeBTModule, SymbolsPerRegionBTModule, UniqueShapeBTModule, AreaNumberBTModule, DartBTModule, DirectionLinkerBTModule, GalaxyBTModule, LetterBTModule, LotusBTModule, MinesweeperBTModule, MyopiaBTModule, ViewpointBTModule, EventIteratingSolver, Solver, UniversalSolver, AreaNumberModule, CellCountModule, ConnectAllModule, DartModule, allZ3Modules, LetterModule, MyopiaModule, RegionAreaModule, ViewpointModule, Z3Module, convertDirection, Z3Solver, Z3SolverContext, AreaNumberSymbol, CustomIconSymbol, CustomSymbol, CustomTextSymbol, DartSymbol, DirectionLinkerSymbol, GalaxySymbol, HiddenSymbol, allSymbols, LetterSymbol, LotusSymbol, MinesweeperSymbol, MultiEntrySymbol, MyopiaSymbol, NumberSymbol, Symbol, ViewpointSymbol, TileData, TileConnections, validateGrid, aggregateState, applyFinalOverrides, };
+export { ConfigType, configEquals, Configurable, CachedAccess, allEqual, array, directionToRotation, escape, isSameEdge, maxBy, minBy, move, orientationToRotation, resize, unescape, isEventHandler, handlesFinalValidation, handlesGetTile, handlesGridChange, handlesGridResize, handlesSetGrid, invokeSetGrid, handlesSymbolDisplay, handlesSymbolValidation, GridData, NEIGHBOR_OFFSETS, GridConnections, GridZones, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, WRAPPINGS, Wrapping, directionToggle, orientationToggle, MetadataSchema, PuzzleSchema, BanPatternRule, CellCountPerZoneRule, CellCountRule, CompletePatternRule, ConnectAllRule, CustomRule, ForesightRule, allRules, LyingSymbolRule, ControlLine, Row, MusicGridRule, MysteryRule, OffByXRule, PerfectionRule, RegionAreaRule, RegionShapeRule, Rule, SameShapeRule, SymbolsPerRegionRule, UndercluedRule, UniqueShapeRule, WrapAroundRule, Serializer, Compressor, CompressorBase, DeflateCompressor, GzipCompressor, StreamCompressor, SerializerBase, SerializerV0, getShapeVariants, normalizeShape, positionsToShape, shapeEquals, tilesToShape, allSolvers, BacktrackSolver, BTModule, BTGridData, BTTile, IntArray2D, colorToBTTile, createOneTileResult, getOppositeColor, BanPatternBTModule, CellCountBTModule, ConnectAllBTModule, RegionAreaBTModule, RegionShapeBTModule, SameShapeBTModule, SymbolsPerRegionBTModule, UniqueShapeBTModule, AreaNumberBTModule, DartBTModule, DirectionLinkerBTModule, GalaxyBTModule, LetterBTModule, LotusBTModule, MinesweeperBTModule, MyopiaBTModule, ViewpointBTModule, EventIteratingSolver, Solver, UniversalSolver, AreaNumberModule, CellCountModule, ConnectAllModule, DartModule, allZ3Modules, LetterModule, MyopiaModule, RegionAreaModule, ViewpointModule, Z3Module, convertDirection, Z3Solver, Z3SolverContext, AreaNumberSymbol, CustomIconSymbol, CustomSymbol, CustomTextSymbol, DartSymbol, DirectionLinkerSymbol, GalaxySymbol, HiddenSymbol, allSymbols, LetterSymbol, LotusSymbol, MinesweeperSymbol, MultiEntrySymbol, MyopiaSymbol, NumberSymbol, Symbol, ViewpointSymbol, TileData, TileConnections, validateGrid, aggregateState, applyFinalOverrides, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logic-pad/core",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "files": [
     "dist",