@logic-pad/core 0.3.0 → 0.4.1

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

@@ -112,6 +112,30 @@ declare global {
     Create = 'create',
     Solve = 'solve',
   }
+  export declare class GridZones {
+    readonly edges: readonly Edge[];
+    constructor(edges?: readonly Edge[]);
+    addEdge(edge: Edge): GridZones;
+    removeEdge(edge: Edge): GridZones;
+    hasEdge(edge: Edge): boolean;
+    getEdgesAt({ x, y }: Position$1): readonly Edge[];
+    /**
+     * Check if two GridZones objects are equal.
+     * @param other The other GridZones object to compare to.
+     * @returns Whether the two objects are equal.
+     */
+    equals(other: GridZones): boolean;
+    /**
+     * Deduplicate an array of edges.
+     * @param edges The array of edges to deduplicate.
+     * @returns The deduplicated array of edges.
+     */
+    static deduplicateEdges(edges: readonly Edge[]): readonly Edge[];
+    insertColumn(index: number): GridZones;
+    insertRow(index: number): GridZones;
+    removeColumn(index: number): GridZones;
+    removeRow(index: number): GridZones;
+  }
   export declare class TileConnections {
     [y: number]: {
       [x: number]: boolean;
@@ -137,13 +161,10 @@ declare global {
     set bottomRight(value: boolean);
     equals(other: TileConnections): boolean;
   }
-  export declare class GridConnections {
-    readonly edges: readonly Edge[];
+  export declare class GridConnections extends GridZones {
     constructor(edges?: readonly Edge[]);
     addEdge(edge: Edge): GridConnections;
     removeEdge(edge: Edge): GridConnections;
-    isConnected(edge: Edge): boolean;
-    getConnectionsAt({ x, y }: Position$1): readonly Edge[];
     getForTile({ x, y }: Position$1): TileConnections;
     getConnectedTiles({ x, y }: Position$1): readonly Position$1[];
     /**
@@ -156,18 +177,6 @@ declare global {
      * @returns The created connections. You can apply this to a GridData object using GridData.withConnections.
      */
     static create(array: string[]): GridConnections;
-    /**
-     * Check if two GridConnections objects are equal.
-     * @param other The other GridConnections object to compare to.
-     * @returns Whether the two objects are equal.
-     */
-    equals(other: GridConnections): boolean;
-    /**
-     * Deduplicate an array of edges.
-     * @param edges The array of edges to deduplicate.
-     * @returns The deduplicated array of edges.
-     */
-    static deduplicateEdges(edges: readonly Edge[]): readonly Edge[];
     insertColumn(index: number): GridConnections;
     insertRow(index: number): GridConnections;
     removeColumn(index: number): GridConnections;
@@ -188,6 +197,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.
@@ -577,11 +593,13 @@ 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;
     readonly tiles: readonly (readonly TileData[])[];
     readonly connections: GridConnections;
+    readonly zones: GridZones;
     readonly symbols: ReadonlyMap<string, readonly Symbol$1[]>;
     readonly rules: readonly Rule[];
     readonly musicGrid: CachedAccess<MusicGridRule | undefined>;
@@ -593,6 +611,7 @@ declare global {
      * @param height The height of the grid.
      * @param tiles The tiles of the grid.
      * @param connections The connections of the grid, which determines which tiles are merged.
+     * @param zones The zones of the grid.
      * @param symbols The symbols in the grid.
      * @param rules The rules of the grid.
      */
@@ -601,6 +620,7 @@ declare global {
       height: number,
       tiles?: readonly (readonly TileData[])[],
       connections?: GridConnections,
+      zones?: GridZones,
       symbols?: ReadonlyMap<string, readonly Symbol$1[]>,
       rules?: readonly Rule[]
     );
@@ -614,6 +634,7 @@ declare global {
       height,
       tiles,
       connections,
+      zones,
       symbols,
       rules,
     }: {
@@ -621,6 +642,7 @@ declare global {
       height?: number;
       tiles?: readonly (readonly TileData[])[];
       connections?: GridConnections;
+      zones?: GridZones;
       symbols?: ReadonlyMap<string, readonly Symbol$1[]>;
       rules?: readonly Rule[];
     }): GridData;
@@ -668,6 +690,12 @@ declare global {
         | GridConnections
         | ((value: GridConnections) => GridConnections)
     ): GridData;
+    /**
+     * Add or modify the zones in the grid.
+     * @param zones The new zones to add or modify.
+     * @returns The new grid with the new zones.
+     */
+    withZones(zones: GridZones | ((value: GridZones) => GridZones)): GridData;
     /**
      * Add or modify the symbols in the grid.
      * @param symbols The new symbols to add or modify.
@@ -1332,6 +1360,28 @@ declare global {
     copyWith({ pattern }: { pattern?: GridData }): this;
     withPattern(pattern: GridData): this;
   }
+  export declare class CellCountPerZoneRule extends Rule {
+    readonly color: Color;
+    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.
+     */
+    constructor(color: Color);
+    get id(): string;
+    get explanation(): string;
+    get configs(): readonly AnyConfig[] | null;
+    createExampleGrid(): GridData;
+    get searchVariants(): SearchVariant[];
+    validateGrid(grid: GridData): RuleState;
+    copyWith({ color }: { color?: Color }): this;
+    withColor(color: Color): this;
+  }
   export declare class CellCountRule extends Rule {
     readonly color: Color;
     readonly count: number;
@@ -1746,6 +1796,8 @@ declare global {
     abstract parseSymbol(str: string): Symbol$1;
     abstract stringifyConnections(connections: GridConnections): string;
     abstract parseConnections(input: string): GridConnections;
+    abstract stringifyZones(zones: GridZones): string;
+    abstract parseZones(input: string): GridZones;
     abstract stringifyTiles(tiles: readonly (readonly TileData[])[]): string;
     abstract parseTiles(input: string): TileData[][];
     abstract stringifyRules(rules: readonly Rule[]): string;
@@ -1777,6 +1829,8 @@ declare global {
     parseSymbol(str: string): Symbol$1;
     stringifyConnections(connections: GridConnections): string;
     parseConnections(input: string): GridConnections;
+    stringifyZones(zones: GridZones): string;
+    parseZones(input: string): GridZones;
     stringifyTiles(tiles: readonly (readonly TileData[])[]): string;
     parseTiles(input: string): TileData[][];
     stringifyRules(rules: readonly Rule[]): string;

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/grid.d.ts

@@ -7,11 +7,14 @@ import TileData from './tile.js';
 import MusicGridRule from './rules/musicGridRule.js';
 import CompletePatternRule from './rules/completePatternRule.js';
 import UndercluedRule from './rules/undercluedRule.js';
+import GridZones from './gridZones.js';
+export declare const NEIGHBOR_OFFSETS: Position[];
 export default class GridData {
     readonly width: number;
     readonly height: number;
     readonly tiles: readonly (readonly TileData[])[];
     readonly connections: GridConnections;
+    readonly zones: GridZones;
     readonly symbols: ReadonlyMap<string, readonly Symbol[]>;
     readonly rules: readonly Rule[];
     readonly musicGrid: CachedAccess<MusicGridRule | undefined>;
@@ -23,20 +26,22 @@ export default class GridData {
      * @param height The height of the grid.
      * @param tiles The tiles of the grid.
      * @param connections The connections of the grid, which determines which tiles are merged.
+     * @param zones The zones of the grid.
      * @param symbols The symbols in the grid.
      * @param rules The rules of the grid.
      */
-    constructor(width: number, height: number, tiles?: readonly (readonly TileData[])[], connections?: GridConnections, symbols?: ReadonlyMap<string, readonly Symbol[]>, rules?: readonly Rule[]);
+    constructor(width: number, height: number, tiles?: readonly (readonly TileData[])[], connections?: GridConnections, zones?: GridZones, symbols?: ReadonlyMap<string, readonly Symbol[]>, rules?: readonly Rule[]);
     /**
      * Copy the current grid while modifying the provided properties.
      * @param param0 The properties to modify.
      * @returns The new grid with the modified properties.
      */
-    copyWith({ width, height, tiles, connections, symbols, rules, }: {
+    copyWith({ width, height, tiles, connections, zones, symbols, rules, }: {
         width?: number;
         height?: number;
         tiles?: readonly (readonly TileData[])[];
         connections?: GridConnections;
+        zones?: GridZones;
         symbols?: ReadonlyMap<string, readonly Symbol[]>;
         rules?: readonly Rule[];
     }): GridData;
@@ -72,6 +77,12 @@ export default class GridData {
      * @returns The new grid with the new connections.
      */
     withConnections(connections: GridConnections | ((value: GridConnections) => GridConnections)): GridData;
+    /**
+     * Add or modify the zones in the grid.
+     * @param zones The new zones to add or modify.
+     * @returns The new grid with the new zones.
+     */
+    withZones(zones: GridZones | ((value: GridZones) => GridZones)): GridData;
     /**
      * Add or modify the symbols in the grid.
      * @param symbols The new symbols to add or modify.

package/dist/data/grid.js

@@ -5,7 +5,8 @@ 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 = [
+import GridZones from './gridZones.js';
+export const NEIGHBOR_OFFSETS = [
     { x: -1, y: 0 },
     { x: 1, y: 0 },
     { x: 0, y: -1 },
@@ -19,10 +20,11 @@ export default class GridData {
      * @param height The height of the grid.
      * @param tiles The tiles of the grid.
      * @param connections The connections of the grid, which determines which tiles are merged.
+     * @param zones The zones of the grid.
      * @param symbols The symbols in the grid.
      * @param rules The rules of the grid.
      */
-    constructor(width, height, tiles, connections, symbols, rules) {
+    constructor(width, height, tiles, connections, zones, symbols, rules) {
         Object.defineProperty(this, "width", {
             enumerable: true,
             configurable: true,
@@ -47,6 +49,12 @@ export default class GridData {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "zones", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "symbols", {
             enumerable: true,
             configurable: true,
@@ -83,6 +91,7 @@ export default class GridData {
         this.height = height;
         this.tiles = tiles ?? array(width, height, () => TileData.empty());
         this.connections = connections ?? new GridConnections();
+        this.zones = zones ?? new GridZones();
         const newSymbols = symbols
             ? GridData.deduplicateSymbols(symbols)
             : new Map();
@@ -108,8 +117,8 @@ export default class GridData {
      * @param param0 The properties to modify.
      * @returns The new grid with the modified properties.
      */
-    copyWith({ width, height, tiles, connections, symbols, rules, }) {
-        return new GridData(width ?? this.width, height ?? this.height, tiles ?? this.tiles, connections ?? this.connections, symbols ?? this.symbols, rules ?? this.rules);
+    copyWith({ 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);
     }
     isPositionValid(x, y) {
         return x >= 0 && x < this.width && y >= 0 && y < this.height;
@@ -173,6 +182,16 @@ export default class GridData {
                 : connections,
         });
     }
+    /**
+     * Add or modify the zones in the grid.
+     * @param zones The new zones to add or modify.
+     * @returns The new grid with the new zones.
+     */
+    withZones(zones) {
+        return this.copyWith({
+            zones: typeof zones === 'function' ? zones(this.zones) : zones,
+        });
+    }
     /**
      * Add or modify the symbols in the grid.
      * @param symbols The new symbols to add or modify.
@@ -346,6 +365,7 @@ export default class GridData {
             return this.getTile(x - 1, y);
         });
         const connections = this.connections.insertColumn(index);
+        const zones = this.zones.insertColumn(index);
         const rules = this.rules
             .map(rule => {
             if (handlesGridResize(rule))
@@ -366,6 +386,7 @@ export default class GridData {
             width: this.width + 1,
             tiles,
             connections,
+            zones,
             rules,
             symbols,
         });
@@ -386,6 +407,7 @@ export default class GridData {
             return this.getTile(x, y - 1);
         });
         const connections = this.connections.insertRow(index);
+        const zones = this.zones.insertRow(index);
         const rules = this.rules
             .map(rule => {
             if (handlesGridResize(rule))
@@ -406,6 +428,7 @@ export default class GridData {
             height: this.height + 1,
             tiles,
             connections,
+            zones,
             rules,
             symbols,
         });
@@ -420,6 +443,7 @@ export default class GridData {
             return this;
         const tiles = array(this.width - 1, this.height, (x, y) => x < index ? this.getTile(x, y) : this.getTile(x + 1, y));
         const connections = this.connections.removeColumn(index);
+        const zones = this.zones.removeColumn(index);
         const rules = this.rules
             .map(rule => {
             if (handlesGridResize(rule))
@@ -440,6 +464,7 @@ export default class GridData {
             width: this.width - 1,
             tiles,
             connections,
+            zones,
             rules,
             symbols,
         });
@@ -454,6 +479,7 @@ export default class GridData {
             return this;
         const tiles = array(this.width, this.height - 1, (x, y) => y < index ? this.getTile(x, y) : this.getTile(x, y + 1));
         const connections = this.connections.removeRow(index);
+        const zones = this.zones.removeRow(index);
         const rules = this.rules
             .map(rule => {
             if (handlesGridResize(rule))
@@ -474,6 +500,7 @@ export default class GridData {
             height: this.height - 1,
             tiles,
             connections,
+            zones,
             rules,
             symbols,
         });
@@ -573,10 +600,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);
@@ -747,6 +771,21 @@ export default class GridData {
             x2: edge.x2 - origin.x,
             y2: edge.y2 - origin.y,
         })));
+        const zones = new GridZones(this.zones.edges
+            .filter(edge => edge.x1 >= origin.x &&
+            edge.y1 >= origin.y &&
+            edge.x2 >= origin.x &&
+            edge.y2 >= origin.y &&
+            edge.x1 < origin.x + width &&
+            edge.y1 < origin.y + height &&
+            edge.x2 < origin.x + width &&
+            edge.y2 < origin.y + height)
+            .map(edge => ({
+            x1: edge.x1 - origin.x,
+            y1: edge.y1 - origin.y,
+            x2: edge.x2 - origin.x,
+            y2: edge.y2 - origin.y,
+        })));
         const symbols = new Map();
         for (const [id, symbolList] of this.symbols) {
             const newSymbolList = symbolList.filter(symbol => symbol.x >= origin.x &&
@@ -756,7 +795,7 @@ export default class GridData {
             if (newSymbolList.length > 0)
                 symbols.set(id, newSymbolList);
         }
-        return new GridData(width, height, newTiles, connections, symbols, this.rules);
+        return new GridData(width, height, newTiles, connections, zones, symbols, this.rules);
     }
     pasteTiles(origin, grid) {
         if (!(grid instanceof GridData))
@@ -775,6 +814,15 @@ export default class GridData {
                 y2: edge.y2 + origin.y,
             })),
         ]);
+        const zones = new GridZones([
+            ...this.zones.edges,
+            ...grid.zones.edges.map(edge => ({
+                x1: edge.x1 + origin.x,
+                y1: edge.y1 + origin.y,
+                x2: edge.x2 + origin.x,
+                y2: edge.y2 + origin.y,
+            })),
+        ]);
         const symbols = new Map(this.symbols);
         for (const [id, sourceList] of grid.symbols) {
             const symbolList = sourceList.map(symbol => symbol.copyWith({ x: symbol.x + origin.x, y: symbol.y + origin.y }));
@@ -786,7 +834,13 @@ export default class GridData {
             }
         }
         const rules = [...this.rules, ...grid.rules];
-        return this.copyWith({ tiles: newTiles, connections, symbols, rules });
+        return this.copyWith({
+            tiles: newTiles,
+            connections,
+            zones,
+            symbols,
+            rules,
+        });
     }
     /**
      * Check if this grid is equal to another grid in terms of size and tile colors.
@@ -839,6 +893,8 @@ export default class GridData {
             return false;
         if (!this.connections.equals(other.connections))
             return false;
+        if (!this.zones.equals(other.zones))
+            return false;
         if (this.symbols.size !== other.symbols.size)
             return false;
         for (const [id, symbols] of this.symbols) {

package/dist/data/gridConnections.d.ts

@@ -1,12 +1,10 @@
+import GridZones from './gridZones.js';
 import { Edge, Position } from './primitives.js';
 import TileConnections from './tileConnections.js';
-export default class GridConnections {
-    readonly edges: readonly Edge[];
+export default class GridConnections extends GridZones {
     constructor(edges?: readonly Edge[]);
     addEdge(edge: Edge): GridConnections;
     removeEdge(edge: Edge): GridConnections;
-    isConnected(edge: Edge): boolean;
-    getConnectionsAt({ x, y }: Position): readonly Edge[];
     getForTile({ x, y }: Position): TileConnections;
     getConnectedTiles({ x, y }: Position): readonly Position[];
     /**
@@ -19,18 +17,6 @@ export default class GridConnections {
      * @returns The created connections. You can apply this to a GridData object using GridData.withConnections.
      */
     static create(array: string[]): GridConnections;
-    /**
-     * Check if two GridConnections objects are equal.
-     * @param other The other GridConnections object to compare to.
-     * @returns Whether the two objects are equal.
-     */
-    equals(other: GridConnections): boolean;
-    /**
-     * Deduplicate an array of edges.
-     * @param edges The array of edges to deduplicate.
-     * @returns The deduplicated array of edges.
-     */
-    static deduplicateEdges(edges: readonly Edge[]): readonly Edge[];
     insertColumn(index: number): GridConnections;
     insertRow(index: number): GridConnections;
     removeColumn(index: number): GridConnections;

package/dist/data/gridConnections.js

@@ -1,17 +1,9 @@
+import { isSameEdge } from './dataHelper.js';
+import GridZones from './gridZones.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 {
+export default class GridConnections extends GridZones {
     constructor(edges) {
-        Object.defineProperty(this, "edges", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        this.edges = GridConnections.deduplicateEdges(edges ?? []);
+        super(edges);
     }
     addEdge(edge) {
         if (this.edges.some(e => isSameEdge(e, edge))) {
@@ -22,26 +14,18 @@ export default class GridConnections {
     removeEdge(edge) {
         return new GridConnections(this.edges.filter(e => !isSameEdge(e, edge)));
     }
-    isConnected(edge) {
-        if (edge.x1 === edge.x2 && edge.y1 === edge.y2)
-            return true;
-        return this.edges.some(e => isSameEdge(e, edge));
-    }
-    getConnectionsAt({ x, y }) {
-        return this.edges.filter(e => (e.x1 === x && e.y1 === y) || (e.x2 === x && e.y2 === y));
-    }
     getForTile({ x, y }) {
         const result = new TileConnections();
         // Get all connections within 2 steps of the tile
-        const edges = this.getConnectionsAt({ x, y });
+        const edges = this.getEdgesAt({ x, y });
         const edges2 = [
             ...edges,
             ...edges.flatMap(edge => {
                 if (edge.x1 === x && edge.y1 === y) {
-                    return this.getConnectionsAt({ x: edge.x2, y: edge.y2 });
+                    return this.getEdgesAt({ x: edge.x2, y: edge.y2 });
                 }
                 else {
-                    return this.getConnectionsAt({ x: edge.x1, y: edge.y1 });
+                    return this.getEdgesAt({ x: edge.x1, y: edge.y1 });
                 }
             }),
         ];
@@ -89,7 +73,7 @@ export default class GridConnections {
             }
             visited.add(`${current.x},${current.y}`);
             result.push(current);
-            const edges = this.getConnectionsAt(current);
+            const edges = this.getEdgesAt(current);
             for (const edge of edges) {
                 if (edge.x1 === current.x && edge.y1 === current.y) {
                     queue.push({ x: edge.x2, y: edge.y2 });
@@ -127,28 +111,6 @@ export default class GridConnections {
         }
         return new GridConnections(edges);
     }
-    /**
-     * Check if two GridConnections objects are equal.
-     * @param other The other GridConnections object to compare to.
-     * @returns Whether the two objects are equal.
-     */
-    equals(other) {
-        if (this.edges.length !== other.edges.length)
-            return false;
-        for (const edge of this.edges) {
-            if (!other.isConnected(edge))
-                return false;
-        }
-        return true;
-    }
-    /**
-     * Deduplicate an array of edges.
-     * @param edges The array of edges to deduplicate.
-     * @returns The deduplicated array of edges.
-     */
-    static deduplicateEdges(edges) {
-        return edges.filter((edge, index) => edges.findIndex(e => isSameEdge(e, edge)) === index);
-    }
     insertColumn(index) {
         return new GridConnections(this.edges.flatMap(edge => {
             if ((edge.x1 < index && edge.x2 < index) ||

package/dist/data/gridZones.d.ts

@@ -0,0 +1,25 @@
+import { Edge, Position } from './primitives.js';
+export default class GridZones {
+    readonly edges: readonly Edge[];
+    constructor(edges?: readonly Edge[]);
+    addEdge(edge: Edge): GridZones;
+    removeEdge(edge: Edge): GridZones;
+    hasEdge(edge: Edge): boolean;
+    getEdgesAt({ x, y }: Position): readonly Edge[];
+    /**
+     * Check if two GridZones objects are equal.
+     * @param other The other GridZones object to compare to.
+     * @returns Whether the two objects are equal.
+     */
+    equals(other: GridZones): boolean;
+    /**
+     * Deduplicate an array of edges.
+     * @param edges The array of edges to deduplicate.
+     * @returns The deduplicated array of edges.
+     */
+    static deduplicateEdges(edges: readonly Edge[]): readonly Edge[];
+    insertColumn(index: number): GridZones;
+    insertRow(index: number): GridZones;
+    removeColumn(index: number): GridZones;
+    removeRow(index: number): GridZones;
+}

package/dist/data/gridZones.js

@@ -0,0 +1,91 @@
+import { isSameEdge } from './dataHelper.js';
+export default class GridZones {
+    constructor(edges) {
+        Object.defineProperty(this, "edges", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.edges = GridZones.deduplicateEdges(edges ?? []);
+    }
+    addEdge(edge) {
+        if (this.edges.some(e => isSameEdge(e, edge))) {
+            return this;
+        }
+        return new GridZones([...this.edges, edge]);
+    }
+    removeEdge(edge) {
+        return new GridZones(this.edges.filter(e => !isSameEdge(e, edge)));
+    }
+    hasEdge(edge) {
+        if (edge.x1 === edge.x2 && edge.y1 === edge.y2)
+            return true;
+        return this.edges.some(e => isSameEdge(e, edge));
+    }
+    getEdgesAt({ x, y }) {
+        return this.edges.filter(e => (e.x1 === x && e.y1 === y) || (e.x2 === x && e.y2 === y));
+    }
+    /**
+     * Check if two GridZones objects are equal.
+     * @param other The other GridZones object to compare to.
+     * @returns Whether the two objects are equal.
+     */
+    equals(other) {
+        if (this.edges.length !== other.edges.length)
+            return false;
+        for (const edge of this.edges) {
+            if (!other.hasEdge(edge))
+                return false;
+        }
+        return true;
+    }
+    /**
+     * Deduplicate an array of edges.
+     * @param edges The array of edges to deduplicate.
+     * @returns The deduplicated array of edges.
+     */
+    static deduplicateEdges(edges) {
+        return edges.filter((edge, index) => edges.findIndex(e => isSameEdge(e, edge)) === index);
+    }
+    insertColumn(index) {
+        return new GridZones(this.edges.map(edge => {
+            if (edge.x1 < index || edge.x2 < index) {
+                return edge;
+            }
+            else {
+                return { x1: edge.x1 + 1, y1: edge.y1, x2: edge.x2 + 1, y2: edge.y2 };
+            }
+        }));
+    }
+    insertRow(index) {
+        return new GridZones(this.edges.map(edge => {
+            if (edge.y1 < index || edge.y2 < index) {
+                return edge;
+            }
+            else {
+                return { x1: edge.x1, y1: edge.y1 + 1, x2: edge.x2, y2: edge.y2 + 1 };
+            }
+        }));
+    }
+    removeColumn(index) {
+        return new GridZones(this.edges.map(edge => {
+            if (edge.x1 > index || edge.x2 > index) {
+                return { x1: edge.x1 - 1, y1: edge.y1, x2: edge.x2 - 1, y2: edge.y2 };
+            }
+            else {
+                return edge;
+            }
+        }));
+    }
+    removeRow(index) {
+        return new GridZones(this.edges.map(edge => {
+            if (edge.y1 > index || edge.y2 > index) {
+                return { x1: edge.x1, y1: edge.y1 - 1, x2: edge.x2, y2: edge.y2 - 1 };
+            }
+            else {
+                return edge;
+            }
+        }));
+    }
+}

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

@@ -0,0 +1,29 @@
+import { AnyConfig } from '../config.js';
+import GridData from '../grid.js';
+import { Color, RuleState } from '../primitives.js';
+import Rule, { SearchVariant } from './rule.js';
+export default class CellCountPerZoneRule extends Rule {
+    readonly color: Color;
+    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.
+     */
+    constructor(color: Color);
+    get id(): string;
+    get explanation(): string;
+    get configs(): readonly AnyConfig[] | null;
+    createExampleGrid(): GridData;
+    get searchVariants(): SearchVariant[];
+    validateGrid(grid: GridData): RuleState;
+    copyWith({ color }: {
+        color?: Color;
+    }): this;
+    withColor(color: Color): this;
+}
+export declare const instance: CellCountPerZoneRule;

package/dist/data/rules/cellCountPerZoneRule.js

@@ -0,0 +1,165 @@
+import { ConfigType } from '../config.js';
+import { array } from '../dataHelper.js';
+import GridData, { NEIGHBOR_OFFSETS } from '../grid.js';
+import GridZones from '../gridZones.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.
+     */
+    constructor(color) {
+        super();
+        Object.defineProperty(this, "color", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: color
+        });
+        this.color = color;
+    }
+    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 (!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 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 }) {
+        return new CellCountPerZoneRule(color ?? this.color);
+    }
+    withColor(color) {
+        return this.copyWith({ color });
+    }
+}
+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,
+        },
+    ])
+});
+Object.defineProperty(CellCountPerZoneRule, "EXAMPLE_GRID_LIGHT", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: Object.freeze(GridData.create(['bwbbb', 'wbbwb', 'bbbwb', 'bwbwb'])
+        .withZones(new GridZones([
+        { 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 },
+    ]))
+        .addRule(new CellCountPerZoneRule(Color.Light)))
+});
+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/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';

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';

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

@@ -4,6 +4,7 @@ import Rule from '../rules/rule.js';
 import TileData from '../tile.js';
 import Symbol from '../symbols/symbol.js';
 import { Puzzle } from '../puzzle.js';
+import GridZones from '../gridZones.js';
 export default abstract class SerializerBase {
     abstract get version(): number;
     abstract stringifyTile(tile: TileData): string;
@@ -14,6 +15,8 @@ export default abstract class SerializerBase {
     abstract parseSymbol(str: string): Symbol;
     abstract stringifyConnections(connections: GridConnections): string;
     abstract parseConnections(input: string): GridConnections;
+    abstract stringifyZones(zones: GridZones): string;
+    abstract parseZones(input: string): GridZones;
     abstract stringifyTiles(tiles: readonly (readonly TileData[])[]): string;
     abstract parseTiles(input: string): TileData[][];
     abstract stringifyRules(rules: readonly Rule[]): string;

package/dist/data/serializer/serializer_v0.d.ts

@@ -8,6 +8,7 @@ import { AnyConfig } from '../config.js';
 import SerializerBase from './serializerBase.js';
 import { Puzzle } from '../puzzle.js';
 import { ControlLine } from '../rules/musicControlLine.js';
+import GridZones from '../gridZones.js';
 export default class SerializerV0 extends SerializerBase {
     readonly version = 0;
     stringifyTile(tile: TileData): string;
@@ -23,6 +24,8 @@ export default class SerializerV0 extends SerializerBase {
     parseSymbol(str: string): Symbol;
     stringifyConnections(connections: GridConnections): string;
     parseConnections(input: string): GridConnections;
+    stringifyZones(zones: GridZones): string;
+    parseZones(input: string): GridZones;
     stringifyTiles(tiles: readonly (readonly TileData[])[]): string;
     parseTiles(input: string): TileData[][];
     stringifyRules(rules: readonly Rule[]): string;

package/dist/data/serializer/serializer_v0.js

@@ -8,6 +8,7 @@ import { allRules } from '../rules/index.js';
 import { allSymbols } from '../symbols/index.js';
 import SerializerBase from './serializerBase.js';
 import { ControlLine, Row } from '../rules/musicControlLine.js';
+import GridZones from '../gridZones.js';
 const OFFSETS = [
     { x: 0, y: -1 },
     { x: -1, y: 0 },
@@ -314,6 +315,19 @@ export default class SerializerV0 extends SerializerBase {
         const tiles = array(width, Math.ceil(data.length / width), (x, y) => data[y * width + x]);
         return GridConnections.create(tiles.map(row => row.join('')));
     }
+    stringifyZones(zones) {
+        return `Z${zones.edges.map(edge => `${edge.x1}_${edge.y1}_${edge.x2 - edge.x1}_${edge.y2 - edge.y1}`).join(':')}`;
+    }
+    parseZones(input) {
+        if (!input.startsWith('Z')) {
+            throw new Error('Invalid grid zones\n' + input);
+        }
+        const data = input.slice(1).split(':');
+        return new GridZones(data.map(entry => {
+            const [x1, y1, w, h] = entry.split('_').map(Number);
+            return { x1, y1, x2: x1 + w, y2: y1 + h };
+        }));
+    }
     stringifyTiles(tiles) {
         return `T${tiles[0]?.length ?? 0}:${tiles.map(row => row.map(tile => this.stringifyTile(tile)).join('')).join('')}`;
     }
@@ -368,6 +382,7 @@ export default class SerializerV0 extends SerializerBase {
         const data = [
             this.stringifyTiles(grid.tiles),
             this.stringifyConnections(grid.connections),
+            this.stringifyZones(grid.zones),
             this.stringifySymbols(grid.symbols),
             this.stringifyRules(grid.rules),
         ];
@@ -379,6 +394,7 @@ export default class SerializerV0 extends SerializerBase {
         let height;
         let tiles;
         let connections;
+        let zones;
         let symbols;
         let rules;
         for (const d of data) {
@@ -391,6 +407,9 @@ export default class SerializerV0 extends SerializerBase {
             else if (d.startsWith('C')) {
                 connections = this.parseConnections(d);
             }
+            else if (d.startsWith('Z')) {
+                zones = this.parseZones(d);
+            }
             else if (d.startsWith('S')) {
                 symbols = this.parseSymbols(d);
             }
@@ -401,7 +420,7 @@ export default class SerializerV0 extends SerializerBase {
                 throw new Error(`Invalid data: ${d}`);
             }
         }
-        return new GridData(width ?? tiles?.[0].length ?? 0, height ?? tiles?.length ?? 0, tiles, connections, symbols, rules);
+        return new GridData(width ?? tiles?.[0].length ?? 0, height ?? tiles?.length ?? 0, tiles, connections, zones, symbols, rules);
     }
     stringifyPuzzle(puzzle) {
         let grid = puzzle.grid;

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,14 @@ 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 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 { 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';
@@ -96,4 +98,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, 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, };
+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, GridZones, 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,14 @@ 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 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 { 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';
@@ -99,4 +101,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, 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, };
+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, GridZones, 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.3.0",
+  "version": "0.4.1",
   "type": "module",
   "files": [
     "dist",