@logic-pad/core 0.2.2 → 0.4.0

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

@@ -188,6 +188,13 @@ declare global {
     x: number;
     y: number;
   };
+  /**
+   * Check if two edges are the same, regardless of direction.
+   * @param a The first edge.
+   * @param b The second edge.
+   * @returns Whether the edges are the same.
+   */
+  export declare function isSameEdge(a: Edge, b: Edge): boolean;
   /**
    * Convert the given direction to a rotation in degrees.
    * @param direction The direction to convert.
@@ -401,7 +408,11 @@ declare global {
     val: T
   ): val is T & GridChangeHandler;
   export interface SetGridHandler {
-    onSetGrid(oldGrid: GridData, newGrid: GridData): GridData;
+    onSetGrid(
+      oldGrid: GridData,
+      newGrid: GridData,
+      solution: GridData | null
+    ): GridData;
   }
   export declare function handlesSetGrid<T extends Instruction>(
     val: T
@@ -504,7 +515,11 @@ declare global {
     createExampleGrid(): GridData;
     get searchVariants(): SearchVariant[];
     validateGrid(_grid: GridData): RuleState;
-    onSetGrid(_oldGrid: GridData, newGrid: GridData): GridData;
+    onSetGrid(
+      _oldGrid: GridData,
+      newGrid: GridData,
+      _solution: GridData | null
+    ): GridData;
     onGridChange(newGrid: GridData): this;
     onGridResize(
       _grid: GridData,
@@ -569,6 +584,7 @@ declare global {
     get validateWithSolution(): boolean;
     get isSingleton(): boolean;
   }
+  export declare const NEIGHBOR_OFFSETS: Position$1[];
   export declare class GridData {
     readonly width: number;
     readonly height: number;
@@ -944,6 +960,14 @@ declare global {
      * @returns True if the grids are equal in size and tile colors, false otherwise.
      */
     colorEquals(grid: GridData): boolean;
+    /**
+     * Check if this grid conforms to the given solution, or an incomplete version of the solution.
+     * Symbols and rules are not validated.
+     *
+     * @param solution The solution to compare with.
+     * @returns True if the grid conforms to the solution, false otherwise.
+     */
+    solutionMatches(solution: GridData): boolean;
     /**
      * Check if this grid is equal to another grid in terms of size, tile colors, connections, symbols, and rules.
      *
@@ -1014,6 +1038,8 @@ declare global {
     Icon = 'icon',
     ControlLines = 'controlLines',
     NullableNote = 'nullableNote',
+    SolvePath = 'solvePath',
+    Edges = 'edges',
   }
   export interface Config<T> {
     readonly type: ConfigType;
@@ -1084,6 +1110,12 @@ declare global {
   export interface NullableNoteConfig extends Config<string | null> {
     readonly type: ConfigType.NullableNote;
   }
+  export interface SolvePathConfig extends Config<Position$1[]> {
+    readonly type: ConfigType.SolvePath;
+  }
+  export interface EdgesConfig extends Config<Edge[]> {
+    readonly type: ConfigType.Edges;
+  }
   export type AnyConfig =
     | BooleanConfig
     | NullableBooleanConfig
@@ -1101,7 +1133,9 @@ declare global {
     | NullableGridConfig
     | IconConfig
     | ControlLinesConfig
-    | NullableNoteConfig;
+    | NullableNoteConfig
+    | SolvePathConfig
+    | EdgesConfig;
   /**
    * Compare two config values for equality, using an appropriate method for the config type.
    *
@@ -1311,6 +1345,39 @@ declare global {
     copyWith({ pattern }: { pattern?: GridData }): this;
     withPattern(pattern: GridData): this;
   }
+  export declare class CellCountPerZoneRule extends Rule {
+    readonly color: Color;
+    readonly edges: readonly Edge[];
+    private static readonly CONFIGS;
+    private static readonly EXAMPLE_GRID_LIGHT;
+    private static readonly EXAMPLE_GRID_DARK;
+    private static readonly EXAMPLE_GRID_GRAY;
+    private static readonly SEARCH_VARIANTS;
+    /**
+     * **Every zone has the same number of &lt;color&gt; cells.**
+     *
+     * @param color - The color of the cells to count.
+     * @param edges - The edges of the zones to count.
+     */
+    constructor(color: Color, edges: readonly Edge[]);
+    get id(): string;
+    get explanation(): string;
+    get configs(): readonly AnyConfig[] | null;
+    createExampleGrid(): GridData;
+    get searchVariants(): SearchVariant[];
+    validateGrid(grid: GridData): RuleState;
+    copyWith({
+      color,
+      edges,
+    }: {
+      color?: Color;
+      edges?: readonly Edge[];
+    }): this;
+    withColor(color: Color): this;
+    withEdges(
+      edges: readonly Edge[] | ((edges: readonly Edge[]) => readonly Edge[])
+    ): this;
+  }
   export declare class CellCountRule extends Rule {
     readonly color: Color;
     readonly count: number;
@@ -1390,13 +1457,19 @@ declare global {
     readonly count: number;
     readonly regenInterval: number;
     readonly startFull: boolean;
+    readonly solvePath: Position$1[];
     private static readonly EXAMPLE_GRID;
     private static readonly CONFIGS;
     private static readonly SEARCH_VARIANTS;
     /**
      * **Foresight: Show hints**
      */
-    constructor(count: number, regenInterval: number, startFull: boolean);
+    constructor(
+      count: number,
+      regenInterval: number,
+      startFull: boolean,
+      solvePath?: Position$1[]
+    );
     get id(): string;
     get explanation(): string;
     get visibleWhenSolving(): boolean;
@@ -1410,10 +1483,12 @@ declare global {
       count,
       regenInterval,
       startFull,
+      solvePath,
     }: {
       count?: number;
       regenInterval?: number;
       startFull?: boolean;
+      solvePath?: Position$1[];
     }): this;
   }
   export declare const allRules: Map<string, Rule>;
@@ -1490,6 +1565,45 @@ declare global {
     copyWith({ number }: { number?: number }): this;
     withNumber(number: number): this;
   }
+  export declare class PerfectionRule
+    extends Rule
+    implements SetGridHandler, FinalValidationHandler
+  {
+    private static readonly EXAMPLE_GRID;
+    private static readonly SEARCH_VARIANTS;
+    /**
+     * **Quest for Perfection: cell colors are final**
+     */
+    constructor();
+    get id(): string;
+    get explanation(): string;
+    get configs(): readonly AnyConfig[] | null;
+    createExampleGrid(): GridData;
+    get searchVariants(): SearchVariant[];
+    get necessaryForCompletion(): boolean;
+    get isSingleton(): boolean;
+    validateGrid(grid: GridData): RuleState;
+    /**
+     * If the grid passes validation but is different from the solution, indicate the error in the final state.
+     */
+    onFinalValidation(
+      grid: GridData,
+      solution: GridData | null,
+      state: GridState
+    ): GridState;
+    private fixTiles;
+    /**
+     * Force all tiles to be fixed.
+     *
+     * If the grid is already wrong, prevent the player from changing it further.
+     */
+    onSetGrid(
+      oldGrid: GridData,
+      newGrid: GridData,
+      solution: GridData | null
+    ): GridData;
+    copyWith(_: object): this;
+  }
   export declare class RegionAreaRule extends Rule {
     readonly color: Color;
     readonly size: number;

package/dist/data/config.d.ts

@@ -1,5 +1,5 @@
 import GridData from './grid.js';
-import { Color, Comparison, Direction, DirectionToggle, Orientation, OrientationToggle } from './primitives.js';
+import { Color, Comparison, Direction, DirectionToggle, Edge, Orientation, OrientationToggle, Position } from './primitives.js';
 import { ControlLine } from './rules/musicControlLine.js';
 export declare enum ConfigType {
     Boolean = "boolean",
@@ -18,7 +18,9 @@ export declare enum ConfigType {
     NullableGrid = "nullableGrid",
     Icon = "icon",
     ControlLines = "controlLines",
-    NullableNote = "nullableNote"
+    NullableNote = "nullableNote",
+    SolvePath = "solvePath",
+    Edges = "edges"
 }
 export interface Config<T> {
     readonly type: ConfigType;
@@ -89,7 +91,13 @@ export interface ControlLinesConfig extends Config<ControlLine[]> {
 export interface NullableNoteConfig extends Config<string | null> {
     readonly type: ConfigType.NullableNote;
 }
-export type AnyConfig = BooleanConfig | NullableBooleanConfig | NumberConfig | NullableNumberConfig | StringConfig | ColorConfig | ComparisonConfig | DirectionConfig | DirectionToggleConfig | OrientationConfig | OrientationToggleConfig | TileConfig | GridConfig | NullableGridConfig | IconConfig | ControlLinesConfig | NullableNoteConfig;
+export interface SolvePathConfig extends Config<Position[]> {
+    readonly type: ConfigType.SolvePath;
+}
+export interface EdgesConfig extends Config<Edge[]> {
+    readonly type: ConfigType.Edges;
+}
+export type AnyConfig = BooleanConfig | NullableBooleanConfig | NumberConfig | NullableNumberConfig | StringConfig | ColorConfig | ComparisonConfig | DirectionConfig | DirectionToggleConfig | OrientationConfig | OrientationToggleConfig | TileConfig | GridConfig | NullableGridConfig | IconConfig | ControlLinesConfig | NullableNoteConfig | SolvePathConfig | EdgesConfig;
 /**
  * Compare two config values for equality, using an appropriate method for the config type.
  *

package/dist/data/config.js

@@ -1,3 +1,4 @@
+import { isSameEdge } from './dataHelper.js';
 import { DIRECTIONS, ORIENTATIONS, } from './primitives.js';
 export var ConfigType;
 (function (ConfigType) {
@@ -18,6 +19,8 @@ export var ConfigType;
     ConfigType["Icon"] = "icon";
     ConfigType["ControlLines"] = "controlLines";
     ConfigType["NullableNote"] = "nullableNote";
+    ConfigType["SolvePath"] = "solvePath";
+    ConfigType["Edges"] = "edges";
 })(ConfigType || (ConfigType = {}));
 /**
  * Compare two config values for equality, using an appropriate method for the config type.
@@ -51,5 +54,19 @@ export function configEquals(type, a, b) {
     if (type === ConfigType.OrientationToggle) {
         return ORIENTATIONS.every(dir => a[dir] === b[dir]);
     }
+    if (type === ConfigType.SolvePath) {
+        const aPath = a;
+        const bPath = b;
+        if (aPath.length !== bPath.length)
+            return false;
+        return aPath.every((pos, i) => pos.x === bPath[i].x && pos.y === bPath[i].y);
+    }
+    if (type === ConfigType.Edges) {
+        const aEdges = a;
+        const bEdges = b;
+        if (aEdges.length !== bEdges.length)
+            return false;
+        return aEdges.every(aEdge => bEdges.some(bEdge => isSameEdge(aEdge, bEdge)));
+    }
     return a === b;
 }

package/dist/data/dataHelper.d.ts

@@ -1,4 +1,4 @@
-import { Direction, Orientation, Position } from './primitives.js';
+import { Direction, Edge, Orientation, Position } from './primitives.js';
 /**
  * Offset the given position by a given step in the given direction.
  * @param position The position to offset.
@@ -10,6 +10,13 @@ export declare function move(position: Position, direction: Direction | Orientat
     x: number;
     y: number;
 };
+/**
+ * Check if two edges are the same, regardless of direction.
+ * @param a The first edge.
+ * @param b The second edge.
+ * @returns Whether the edges are the same.
+ */
+export declare function isSameEdge(a: Edge, b: Edge): boolean;
 /**
  * Convert the given direction to a rotation in degrees.
  * @param direction The direction to convert.

package/dist/data/dataHelper.js

@@ -30,6 +30,16 @@ export function move(position, direction, step = 1) {
             return { x: position.x + step, y: position.y + step };
     }
 }
+/**
+ * Check if two edges are the same, regardless of direction.
+ * @param a The first edge.
+ * @param b The second edge.
+ * @returns Whether the edges are the same.
+ */
+export function isSameEdge(a, b) {
+    return ((a.x1 === b.x1 && a.y1 === b.y1 && a.x2 === b.x2 && a.y2 === b.y2) ||
+        (a.x1 === b.x2 && a.y1 === b.y2 && a.x2 === b.x1 && a.y2 === b.y1));
+}
 /**
  * Convert the given direction to a rotation in degrees.
  * @param direction The direction to convert.

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

@@ -1,6 +1,6 @@
 import GridData from '../grid.js';
 import Instruction from '../instruction.js';
 export interface SetGridHandler {
-    onSetGrid(oldGrid: GridData, newGrid: GridData): GridData;
+    onSetGrid(oldGrid: GridData, newGrid: GridData, solution: GridData | null): GridData;
 }
 export declare function handlesSetGrid<T extends Instruction>(val: T): val is T & SetGridHandler;

package/dist/data/grid.d.ts

@@ -7,6 +7,7 @@ import TileData from './tile.js';
 import MusicGridRule from './rules/musicGridRule.js';
 import CompletePatternRule from './rules/completePatternRule.js';
 import UndercluedRule from './rules/undercluedRule.js';
+export declare const NEIGHBOR_OFFSETS: Position[];
 export default class GridData {
     readonly width: number;
     readonly height: number;
@@ -321,6 +322,14 @@ export default class GridData {
      * @returns True if the grids are equal in size and tile colors, false otherwise.
      */
     colorEquals(grid: GridData): boolean;
+    /**
+     * Check if this grid conforms to the given solution, or an incomplete version of the solution.
+     * Symbols and rules are not validated.
+     *
+     * @param solution The solution to compare with.
+     * @returns True if the grid conforms to the solution, false otherwise.
+     */
+    solutionMatches(solution: GridData): boolean;
     /**
      * Check if this grid is equal to another grid in terms of size, tile colors, connections, symbols, and rules.
      *

package/dist/data/grid.js

@@ -5,7 +5,7 @@ import GridConnections from './gridConnections.js';
 import { CachedAccess, array, move } from './dataHelper.js';
 import { Color, MajorRule, } from './primitives.js';
 import TileData from './tile.js';
-const NEIGHBOR_OFFSETS = [
+export const NEIGHBOR_OFFSETS = [
     { x: -1, y: 0 },
     { x: 1, y: 0 },
     { x: 0, y: -1 },
@@ -573,10 +573,7 @@ export default class GridData {
                 return ret;
             for (const offset of NEIGHBOR_OFFSETS) {
                 const next = { x: x + offset.x, y: y + offset.y };
-                if (next.x >= 0 &&
-                    next.x < this.width &&
-                    next.y >= 0 &&
-                    next.y < this.height) {
+                if (this.isPositionValid(next.x, next.y)) {
                     const nextTile = this.getTile(next.x, next.y);
                     if (nextTile.exists && predicate(nextTile))
                         stack.push(next);
@@ -709,13 +706,13 @@ export default class GridData {
         this.symbols.forEach(list => {
             list.forEach(symbol => {
                 if (handlesSetGrid(symbol)) {
-                    newGrid = symbol.onSetGrid(this, newGrid);
+                    newGrid = symbol.onSetGrid(this, newGrid, null);
                 }
             });
         });
         this.rules.forEach(rule => {
             if (handlesSetGrid(rule)) {
-                newGrid = rule.onSetGrid(this, newGrid);
+                newGrid = rule.onSetGrid(this, newGrid, null);
             }
         });
         return newGrid;
@@ -801,6 +798,29 @@ export default class GridData {
             this.tiles.every((row, y) => row.every((tile, x) => (!tile.exists && !grid.getTile(x, y).exists) ||
                 tile.color === grid.getTile(x, y).color)));
     }
+    /**
+     * Check if this grid conforms to the given solution, or an incomplete version of the solution.
+     * Symbols and rules are not validated.
+     *
+     * @param solution The solution to compare with.
+     * @returns True if the grid conforms to the solution, false otherwise.
+     */
+    solutionMatches(solution) {
+        if (this.width !== solution.width)
+            return false;
+        if (this.height !== solution.height)
+            return false;
+        return this.tiles.every((row, y) => row.every((tile, x) => {
+            const solutionTile = solution.getTile(x, y);
+            if (!solutionTile.exists)
+                return true;
+            if (tile.color === Color.Gray)
+                return true;
+            if (solutionTile.color !== tile.color)
+                return false;
+            return true;
+        }));
+    }
     /**
      * Check if this grid is equal to another grid in terms of size, tile colors, connections, symbols, and rules.
      *

package/dist/data/gridConnections.js

@@ -1,8 +1,5 @@
+import { isSameEdge } from './dataHelper.js';
 import TileConnections from './tileConnections.js';
-function isSameEdge(a, b) {
-    return ((a.x1 === b.x1 && a.y1 === b.y1 && a.x2 === b.x2 && a.y2 === b.y2) ||
-        (a.x1 === b.x2 && a.y1 === b.y2 && a.x2 === b.x1 && a.y2 === b.y1));
-}
 export default class GridConnections {
     constructor(edges) {
         Object.defineProperty(this, "edges", {

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

@@ -0,0 +1,33 @@
+import { AnyConfig } from '../config.js';
+import GridData from '../grid.js';
+import { Color, Edge, RuleState } from '../primitives.js';
+import Rule, { SearchVariant } from './rule.js';
+export default class CellCountPerZoneRule extends Rule {
+    readonly color: Color;
+    readonly edges: readonly Edge[];
+    private static readonly CONFIGS;
+    private static readonly EXAMPLE_GRID_LIGHT;
+    private static readonly EXAMPLE_GRID_DARK;
+    private static readonly EXAMPLE_GRID_GRAY;
+    private static readonly SEARCH_VARIANTS;
+    /**
+     * **Every zone has the same number of <color> cells.**
+     *
+     * @param color - The color of the cells to count.
+     * @param edges - The edges of the zones to count.
+     */
+    constructor(color: Color, edges: readonly Edge[]);
+    get id(): string;
+    get explanation(): string;
+    get configs(): readonly AnyConfig[] | null;
+    createExampleGrid(): GridData;
+    get searchVariants(): SearchVariant[];
+    validateGrid(grid: GridData): RuleState;
+    copyWith({ color, edges, }: {
+        color?: Color;
+        edges?: readonly Edge[];
+    }): this;
+    withColor(color: Color): this;
+    withEdges(edges: readonly Edge[] | ((edges: readonly Edge[]) => readonly Edge[])): this;
+}
+export declare const instance: CellCountPerZoneRule;

package/dist/data/rules/cellCountPerZoneRule.js

@@ -0,0 +1,183 @@
+import { ConfigType } from '../config.js';
+import { array } from '../dataHelper.js';
+import GridData, { NEIGHBOR_OFFSETS } from '../grid.js';
+import GridConnections from '../gridConnections.js';
+import { Color, State } from '../primitives.js';
+import Rule from './rule.js';
+class CellCountPerZoneRule extends Rule {
+    /**
+     * **Every zone has the same number of <color> cells.**
+     *
+     * @param color - The color of the cells to count.
+     * @param edges - The edges of the zones to count.
+     */
+    constructor(color, edges) {
+        super();
+        Object.defineProperty(this, "color", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: color
+        });
+        Object.defineProperty(this, "edges", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: edges
+        });
+        this.color = color;
+        this.edges = GridConnections.deduplicateEdges(edges);
+    }
+    get id() {
+        return `zone_cell_count`;
+    }
+    get explanation() {
+        return `Every zone has the same number of ${this.color} cells`;
+    }
+    get configs() {
+        return CellCountPerZoneRule.CONFIGS;
+    }
+    createExampleGrid() {
+        if (this.color === Color.Light) {
+            return CellCountPerZoneRule.EXAMPLE_GRID_LIGHT;
+        }
+        else if (this.color === Color.Dark) {
+            return CellCountPerZoneRule.EXAMPLE_GRID_DARK;
+        }
+        else {
+            return CellCountPerZoneRule.EXAMPLE_GRID_GRAY;
+        }
+    }
+    get searchVariants() {
+        return CellCountPerZoneRule.SEARCH_VARIANTS;
+    }
+    validateGrid(grid) {
+        let complete = true;
+        const visited = array(grid.width, grid.height, (i, j) => !grid.getTile(i, j).exists);
+        const zones = [];
+        while (true) {
+            const seed = grid.find((_tile, x, y) => !visited[y][x]);
+            if (!seed)
+                break;
+            const zone = {
+                positions: [],
+                completed: 0,
+                possible: 0,
+            };
+            const stack = [seed];
+            while (stack.length > 0) {
+                const { x, y } = stack.pop();
+                if (visited[y][x])
+                    continue;
+                visited[y][x] = true;
+                zone.positions.push({ x, y });
+                if (grid.getTile(x, y).color === this.color) {
+                    zone.completed++;
+                }
+                else if (grid.getTile(x, y).color === Color.Gray) {
+                    zone.possible++;
+                    complete = false;
+                }
+                for (const offset of NEIGHBOR_OFFSETS) {
+                    const next = { x: x + offset.x, y: y + offset.y };
+                    if (!this.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 nextTile = grid.getTile(next.x, next.y);
+                        if (nextTile.exists) {
+                            stack.push(next);
+                        }
+                    }
+                }
+            }
+            zones.push(zone);
+        }
+        if (zones.length <= 1) {
+            return { state: complete ? State.Satisfied : State.Incomplete };
+        }
+        else {
+            const errorZone = zones.find(z => zones.some(zz => zz !== z &&
+                (zz.completed > z.completed + z.possible ||
+                    zz.completed + zz.possible < z.completed)));
+            if (errorZone) {
+                return {
+                    state: State.Error,
+                    positions: errorZone.positions,
+                };
+            }
+            else {
+                return { state: complete ? State.Satisfied : State.Incomplete };
+            }
+        }
+    }
+    copyWith({ color, edges, }) {
+        return new CellCountPerZoneRule(color ?? this.color, edges ?? this.edges);
+    }
+    withColor(color) {
+        return this.copyWith({ color });
+    }
+    withEdges(edges) {
+        return this.copyWith({
+            edges: typeof edges === 'function' ? edges(this.edges) : edges,
+        });
+    }
+}
+Object.defineProperty(CellCountPerZoneRule, "CONFIGS", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze([
+        {
+            type: ConfigType.Color,
+            default: Color.Light,
+            allowGray: true,
+            field: 'color',
+            description: 'Color',
+            configurable: true,
+        },
+        {
+            type: ConfigType.Edges,
+            default: [],
+            field: 'edges',
+            description: 'Edges',
+            configurable: false,
+        },
+    ])
+});
+Object.defineProperty(CellCountPerZoneRule, "EXAMPLE_GRID_LIGHT", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze(GridData.create(['bwbbb', 'wbbwb', 'bbbwb', 'bwbwb']).addRule(new CellCountPerZoneRule(Color.Light, [
+        { x1: 0, y1: 1, x2: 0, y2: 2 },
+        { x1: 1, y1: 1, x2: 1, y2: 2 },
+        { x1: 2, y1: 1, x2: 2, y2: 2 },
+        { x1: 3, y1: 1, x2: 3, y2: 2 },
+        { x1: 4, y1: 1, x2: 4, y2: 2 },
+    ])))
+});
+Object.defineProperty(CellCountPerZoneRule, "EXAMPLE_GRID_DARK", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze(CellCountPerZoneRule.EXAMPLE_GRID_LIGHT.withTiles(tiles => tiles.map(row => row.map(tile => tile.withColor(tile.color === Color.Dark ? Color.Light : Color.Dark)))))
+});
+Object.defineProperty(CellCountPerZoneRule, "EXAMPLE_GRID_GRAY", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze(CellCountPerZoneRule.EXAMPLE_GRID_LIGHT.withTiles(tiles => tiles.map(row => row.map(tile => tile.withColor(tile.color === Color.Light ? Color.Gray : tile.color)))))
+});
+Object.defineProperty(CellCountPerZoneRule, "SEARCH_VARIANTS", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: [
+        new CellCountPerZoneRule(Color.Light, []).searchVariant(),
+        new CellCountPerZoneRule(Color.Dark, []).searchVariant(),
+    ]
+});
+export default CellCountPerZoneRule;
+export const instance = new CellCountPerZoneRule(Color.Light, []);

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

@@ -1,18 +1,19 @@
 import { AnyConfig } from '../config.js';
 import GridData from '../grid.js';
-import { RuleState } from '../primitives.js';
+import { RuleState, Position } from '../primitives.js';
 import Rule, { SearchVariant } from './rule.js';
 export default class ForesightRule extends Rule {
     readonly count: number;
     readonly regenInterval: number;
     readonly startFull: boolean;
+    readonly solvePath: Position[];
     private static readonly EXAMPLE_GRID;
     private static readonly CONFIGS;
     private static readonly SEARCH_VARIANTS;
     /**
      * **Foresight: Show hints**
      */
-    constructor(count: number, regenInterval: number, startFull: boolean);
+    constructor(count: number, regenInterval: number, startFull: boolean, solvePath?: Position[]);
     get id(): string;
     get explanation(): string;
     get visibleWhenSolving(): boolean;
@@ -22,10 +23,11 @@ export default class ForesightRule extends Rule {
     validateGrid(_grid: GridData): RuleState;
     get necessaryForCompletion(): boolean;
     get isSingleton(): boolean;
-    copyWith({ count, regenInterval, startFull, }: {
+    copyWith({ count, regenInterval, startFull, solvePath, }: {
         count?: number;
         regenInterval?: number;
         startFull?: boolean;
+        solvePath?: Position[];
     }): this;
 }
 export declare const instance: ForesightRule;

package/dist/data/rules/foresightRule.js

@@ -7,7 +7,7 @@ class ForesightRule extends Rule {
     /**
      * **Foresight: Show hints**
      */
-    constructor(count, regenInterval, startFull) {
+    constructor(count, regenInterval, startFull, solvePath = []) {
         super();
         Object.defineProperty(this, "count", {
             enumerable: true,
@@ -27,9 +27,16 @@ class ForesightRule extends Rule {
             writable: true,
             value: startFull
         });
+        Object.defineProperty(this, "solvePath", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: solvePath
+        });
         this.count = count;
         this.regenInterval = regenInterval;
         this.startFull = startFull;
+        this.solvePath = solvePath;
     }
     get id() {
         return `foresight`;
@@ -58,8 +65,8 @@ class ForesightRule extends Rule {
     get isSingleton() {
         return true;
     }
-    copyWith({ count, regenInterval, startFull, }) {
-        return new ForesightRule(count ?? this.count, regenInterval ?? this.regenInterval, startFull ?? this.startFull);
+    copyWith({ count, regenInterval, startFull, solvePath, }) {
+        return new ForesightRule(count ?? this.count, regenInterval ?? this.regenInterval, startFull ?? this.startFull, solvePath ?? this.solvePath);
     }
 }
 Object.defineProperty(ForesightRule, "EXAMPLE_GRID", {
@@ -96,6 +103,13 @@ Object.defineProperty(ForesightRule, "CONFIGS", {
             description: 'Start with full foresight',
             configurable: true,
         },
+        {
+            type: ConfigType.SolvePath,
+            default: [],
+            field: 'solvePath',
+            description: 'Intended solve path',
+            configurable: true,
+        },
     ])
 });
 Object.defineProperty(ForesightRule, "SEARCH_VARIANTS", {

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

@@ -24,7 +24,7 @@ export default class MusicGridRule extends Rule implements GridChangeHandler, Se
     createExampleGrid(): GridData;
     get searchVariants(): SearchVariant[];
     validateGrid(_grid: GridData): RuleState;
-    onSetGrid(_oldGrid: GridData, newGrid: GridData): GridData;
+    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

@@ -56,7 +56,7 @@ class MusicGridRule extends Rule {
     validateGrid(_grid) {
         return { state: State.Incomplete };
     }
-    onSetGrid(_oldGrid, newGrid) {
+    onSetGrid(_oldGrid, newGrid, _solution) {
         if (newGrid.getTileCount(true, undefined, Color.Gray) === 0)
             return newGrid;
         const tiles = newGrid.tiles.map(row => row.map(tile => tile.color === Color.Gray ? tile.withColor(Color.Light) : tile));

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

@@ -0,0 +1,35 @@
+import { AnyConfig } from '../config.js';
+import GridData from '../grid.js';
+import { GridState, RuleState } from '../primitives.js';
+import Rule, { SearchVariant } from './rule.js';
+import { SetGridHandler } from '../events/onSetGrid.js';
+import { FinalValidationHandler } from '../events/onFinalValidation.js';
+export default class PerfectionRule extends Rule implements SetGridHandler, FinalValidationHandler {
+    private static readonly EXAMPLE_GRID;
+    private static readonly SEARCH_VARIANTS;
+    /**
+     * **Quest for Perfection: cell colors are final**
+     */
+    constructor();
+    get id(): string;
+    get explanation(): string;
+    get configs(): readonly AnyConfig[] | null;
+    createExampleGrid(): GridData;
+    get searchVariants(): SearchVariant[];
+    get necessaryForCompletion(): boolean;
+    get isSingleton(): boolean;
+    validateGrid(grid: GridData): RuleState;
+    /**
+     * If the grid passes validation but is different from the solution, indicate the error in the final state.
+     */
+    onFinalValidation(grid: GridData, solution: GridData | null, state: GridState): GridState;
+    private fixTiles;
+    /**
+     * Force all tiles to be fixed.
+     *
+     * If the grid is already wrong, prevent the player from changing it further.
+     */
+    onSetGrid(oldGrid: GridData, newGrid: GridData, solution: GridData | null): GridData;
+    copyWith(_: object): this;
+}
+export declare const instance: PerfectionRule;

package/dist/data/rules/perfectionRule.js

@@ -0,0 +1,113 @@
+import GridData from '../grid.js';
+import { Color, State } from '../primitives.js';
+import Rule from './rule.js';
+import CustomIconSymbol from '../symbols/customIconSymbol.js';
+class PerfectionRule extends Rule {
+    /**
+     * **Quest for Perfection: cell colors are final**
+     */
+    constructor() {
+        super();
+    }
+    get id() {
+        return `perfection`;
+    }
+    get explanation() {
+        return `*Quest for Perfection*: cell colors are final`;
+    }
+    get configs() {
+        return null;
+    }
+    createExampleGrid() {
+        return PerfectionRule.EXAMPLE_GRID;
+    }
+    get searchVariants() {
+        return PerfectionRule.SEARCH_VARIANTS;
+    }
+    get necessaryForCompletion() {
+        return false;
+    }
+    get isSingleton() {
+        return true;
+    }
+    validateGrid(grid) {
+        if (grid.getTileCount(true, undefined, Color.Gray) > 0) {
+            return { state: State.Incomplete };
+        }
+        else {
+            return { state: State.Satisfied };
+        }
+    }
+    /**
+     * If the grid passes validation but is different from the solution, indicate the error in the final state.
+     */
+    onFinalValidation(grid, solution, state) {
+        if (state.final === State.Error)
+            return state;
+        if (solution === null)
+            return state;
+        const positions = [];
+        grid.tiles.forEach((row, y) => row.forEach((t, x) => {
+            if (t.exists &&
+                t.color !== Color.Gray &&
+                t.color !== solution.getTile(x, y).color) {
+                positions.push({ x, y });
+            }
+        }));
+        if (positions.length > 0) {
+            const ruleId = grid.rules.indexOf(this);
+            return {
+                final: State.Error,
+                rules: state.rules.map((r, idx) => {
+                    if (idx === ruleId) {
+                        return { state: State.Error, positions };
+                    }
+                    else {
+                        return r;
+                    }
+                }),
+                symbols: state.symbols,
+            };
+        }
+        return state;
+    }
+    fixTiles(grid) {
+        if (grid.getTileCount(true, false, Color.Light) > 0 ||
+            grid.getTileCount(true, false, Color.Dark) > 0) {
+            return grid.withTiles(tiles => tiles.map(row => row.map(t => t.exists && t.color !== Color.Gray ? t.withFixed(true) : t)));
+        }
+        return grid;
+    }
+    /**
+     * Force all tiles to be fixed.
+     *
+     * If the grid is already wrong, prevent the player from changing it further.
+     */
+    onSetGrid(oldGrid, newGrid, solution) {
+        if (!solution) {
+            return this.fixTiles(newGrid);
+        }
+        if (!oldGrid.solutionMatches(solution) &&
+            !newGrid.solutionMatches(solution)) {
+            return this.fixTiles(oldGrid);
+        }
+        return this.fixTiles(newGrid);
+    }
+    copyWith(_) {
+        return new PerfectionRule();
+    }
+}
+Object.defineProperty(PerfectionRule, "EXAMPLE_GRID", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze(GridData.create(['w']).addSymbol(new CustomIconSymbol('', GridData.create(['w']), 0, 0, 'MdStars')))
+});
+Object.defineProperty(PerfectionRule, "SEARCH_VARIANTS", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: []
+}); // this rule is not searchable
+export default PerfectionRule;
+export const instance = new PerfectionRule();

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

@@ -1,4 +1,5 @@
 export { instance as BanPatternRule } from './banPatternRule.js';
+export { instance as CellCountPerZoneRule } from './cellCountPerZoneRule.js';
 export { instance as CellCountRule } from './cellCountRule.js';
 export { instance as CompletePatternRule } from './completePatternRule.js';
 export { instance as ConnectAllRule } from './connectAllRule.js';
@@ -7,6 +8,7 @@ export { instance as ForesightRule } from './foresightRule.js';
 export { instance as MusicGridRule } from './musicGridRule.js';
 export { instance as MysteryRule } from './mysteryRule.js';
 export { instance as OffByXRule } from './offByXRule.js';
+export { instance as PerfectionRule } from './perfectionRule.js';
 export { instance as RegionAreaRule } from './regionAreaRule.js';
 export { instance as SameShapeRule } from './sameShapeRule.js';
 export { instance as SymbolsPerRegionRule } from './symbolsPerRegionRule.js';

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

@@ -3,6 +3,7 @@
 // @ts-nocheck
 // noinspection JSUnusedGlobalSymbols
 export { instance as BanPatternRule } from './banPatternRule.js';
+export { instance as CellCountPerZoneRule } from './cellCountPerZoneRule.js';
 export { instance as CellCountRule } from './cellCountRule.js';
 export { instance as CompletePatternRule } from './completePatternRule.js';
 export { instance as ConnectAllRule } from './connectAllRule.js';
@@ -11,6 +12,7 @@ export { instance as ForesightRule } from './foresightRule.js';
 export { instance as MusicGridRule } from './musicGridRule.js';
 export { instance as MysteryRule } from './mysteryRule.js';
 export { instance as OffByXRule } from './offByXRule.js';
+export { instance as PerfectionRule } from './perfectionRule.js';
 export { instance as RegionAreaRule } from './regionAreaRule.js';
 export { instance as SameShapeRule } from './sameShapeRule.js';
 export { instance as SymbolsPerRegionRule } from './symbolsPerRegionRule.js';

package/dist/data/serializer/serializer_v0.js

@@ -161,6 +161,18 @@ export default class SerializerV0 extends SerializerBase {
                     escape(instruction[config.field]
                         .map(line => this.stringifyControlLine(line))
                         .join(':')));
+            case ConfigType.SolvePath:
+                return (config.field +
+                    '=' +
+                    escape(instruction[config.field]
+                        ?.map(pos => `${pos.x}_${pos.y}`)
+                        .join('/') ?? ''));
+            case ConfigType.Edges:
+                return (config.field +
+                    '=' +
+                    instruction[config.field]
+                        .map(edge => `${edge.x1}_${edge.y1}_${edge.x2}_${edge.y2}`)
+                        .join('/'));
         }
     }
     parseConfig(configs, entry) {
@@ -219,6 +231,31 @@ export default class SerializerV0 extends SerializerBase {
                 ];
             case ConfigType.NullableNote:
                 return [config.field, value === '' ? null : unescape(value)];
+            case ConfigType.SolvePath:
+                return [
+                    config.field,
+                    value === ''
+                        ? []
+                        : value.split('/').map(pos => {
+                            const [x, y] = pos.split('_');
+                            return { x: Number(x), y: Number(y) };
+                        }),
+                ];
+            case ConfigType.Edges:
+                return [
+                    config.field,
+                    value === ''
+                        ? []
+                        : value.split('/').map(edge => {
+                            const [x1, y1, x2, y2] = edge.split('_');
+                            return {
+                                x1: Number(x1),
+                                y1: Number(y1),
+                                x2: Number(x2),
+                                y2: Number(y2),
+                            };
+                        }),
+                ];
         }
     }
     stringifyInstruction(instruction) {

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { ConfigType, configEquals } from './data/config.js';
 import Configurable from './data/configurable.js';
-import { CachedAccess, allEqual, array, directionToRotation, escape, maxBy, minBy, move, orientationToRotation, resize, unescape } from './data/dataHelper.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 { handlesGridChange } from './data/events/onGridChange.js';
@@ -8,12 +8,13 @@ import { handlesGridResize } from './data/events/onGridResize.js';
 import { handlesSetGrid } from './data/events/onSetGrid.js';
 import { handlesSymbolDisplay } from './data/events/onSymbolDisplay.js';
 import { handlesSymbolValidation } from './data/events/onSymbolValidation.js';
-import GridData from './data/grid.js';
+import GridData, { NEIGHBOR_OFFSETS } from './data/grid.js';
 import GridConnections from './data/gridConnections.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 { MetadataSchema, PuzzleSchema } from './data/puzzle.js';
 import BanPatternRule from './data/rules/banPatternRule.js';
+import CellCountPerZoneRule from './data/rules/cellCountPerZoneRule.js';
 import CellCountRule from './data/rules/cellCountRule.js';
 import CompletePatternRule from './data/rules/completePatternRule.js';
 import ConnectAllRule from './data/rules/connectAllRule.js';
@@ -24,6 +25,7 @@ import { ControlLine, Row } from './data/rules/musicControlLine.js';
 import MusicGridRule from './data/rules/musicGridRule.js';
 import MysteryRule from './data/rules/mysteryRule.js';
 import OffByXRule from './data/rules/offByXRule.js';
+import PerfectionRule from './data/rules/perfectionRule.js';
 import RegionAreaRule from './data/rules/regionAreaRule.js';
 import RegionShapeRule from './data/rules/regionShapeRule.js';
 import Rule from './data/rules/rule.js';
@@ -95,4 +97,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, maxBy, minBy, move, orientationToRotation, resize, unescape, isEventHandler, handlesFinalValidation, handlesGridChange, handlesGridResize, handlesSetGrid, handlesSymbolDisplay, handlesSymbolValidation, GridData, GridConnections, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, directionToggle, orientationToggle, MetadataSchema, PuzzleSchema, BanPatternRule, CellCountRule, CompletePatternRule, ConnectAllRule, CustomRule, ForesightRule, allRules, ControlLine, Row, MusicGridRule, MysteryRule, OffByXRule, 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, Solver, UndercluedSolver, 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, handlesGridChange, handlesGridResize, handlesSetGrid, handlesSymbolDisplay, handlesSymbolValidation, GridData, NEIGHBOR_OFFSETS, GridConnections, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, directionToggle, orientationToggle, MetadataSchema, PuzzleSchema, BanPatternRule, CellCountPerZoneRule, CellCountRule, CompletePatternRule, ConnectAllRule, CustomRule, ForesightRule, allRules, 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, Solver, UndercluedSolver, 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

@@ -3,7 +3,7 @@
 // noinspection JSUnusedGlobalSymbols
 import { ConfigType, configEquals } from './data/config.js';
 import Configurable from './data/configurable.js';
-import { CachedAccess, allEqual, array, directionToRotation, escape, maxBy, minBy, move, orientationToRotation, resize, unescape } from './data/dataHelper.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 { handlesGridChange } from './data/events/onGridChange.js';
@@ -11,12 +11,13 @@ import { handlesGridResize } from './data/events/onGridResize.js';
 import { handlesSetGrid } from './data/events/onSetGrid.js';
 import { handlesSymbolDisplay } from './data/events/onSymbolDisplay.js';
 import { handlesSymbolValidation } from './data/events/onSymbolValidation.js';
-import GridData from './data/grid.js';
+import GridData, { NEIGHBOR_OFFSETS } from './data/grid.js';
 import GridConnections from './data/gridConnections.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 { MetadataSchema, PuzzleSchema } from './data/puzzle.js';
 import BanPatternRule from './data/rules/banPatternRule.js';
+import CellCountPerZoneRule from './data/rules/cellCountPerZoneRule.js';
 import CellCountRule from './data/rules/cellCountRule.js';
 import CompletePatternRule from './data/rules/completePatternRule.js';
 import ConnectAllRule from './data/rules/connectAllRule.js';
@@ -27,6 +28,7 @@ import { ControlLine, Row } from './data/rules/musicControlLine.js';
 import MusicGridRule from './data/rules/musicGridRule.js';
 import MysteryRule from './data/rules/mysteryRule.js';
 import OffByXRule from './data/rules/offByXRule.js';
+import PerfectionRule from './data/rules/perfectionRule.js';
 import RegionAreaRule from './data/rules/regionAreaRule.js';
 import RegionShapeRule from './data/rules/regionShapeRule.js';
 import Rule from './data/rules/rule.js';
@@ -98,4 +100,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, maxBy, minBy, move, orientationToRotation, resize, unescape, isEventHandler, handlesFinalValidation, handlesGridChange, handlesGridResize, handlesSetGrid, handlesSymbolDisplay, handlesSymbolValidation, GridData, GridConnections, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, directionToggle, orientationToggle, MetadataSchema, PuzzleSchema, BanPatternRule, CellCountRule, CompletePatternRule, ConnectAllRule, CustomRule, ForesightRule, allRules, ControlLine, Row, MusicGridRule, MysteryRule, OffByXRule, 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, Solver, UndercluedSolver, 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, handlesGridChange, handlesGridResize, handlesSetGrid, handlesSymbolDisplay, handlesSymbolValidation, GridData, NEIGHBOR_OFFSETS, GridConnections, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, Direction, MajorRule, Mode, ORIENTATIONS, Orientation, State, directionToggle, orientationToggle, MetadataSchema, PuzzleSchema, BanPatternRule, CellCountPerZoneRule, CellCountRule, CompletePatternRule, ConnectAllRule, CustomRule, ForesightRule, allRules, 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, Solver, UndercluedSolver, 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.2.2",
+  "version": "0.4.0",
   "type": "module",
   "files": [
     "dist",