@logic-pad/core 0.24.0 → 0.25.1

package/dist/{data → src/data}/symbols/viewpointSymbol.js

@@ -3,7 +3,32 @@ import GridData from '../grid.js';
 import { array, move } from '../dataHelper.js';
 import { Color, DIRECTIONS } from '../primitives.js';
 import NumberSymbol from './numberSymbol.js';
-class ViewpointSymbol extends NumberSymbol {
+export default class ViewpointSymbol extends NumberSymbol {
+    title = 'Viewpoint Number';
+    static CONFIGS = Object.freeze([
+        {
+            type: ConfigType.Number,
+            default: 0,
+            field: 'x',
+            description: 'X',
+            configurable: false,
+        },
+        {
+            type: ConfigType.Number,
+            default: 0,
+            field: 'y',
+            description: 'Y',
+            configurable: false,
+        },
+        {
+            type: ConfigType.Number,
+            default: 1,
+            field: 'number',
+            description: 'Number',
+            configurable: true,
+        },
+    ]);
+    static EXAMPLE_GRID = Object.freeze(GridData.create(['bbbbb', 'wwwwb', 'bwwbb', 'bbwww']).addSymbol(new ViewpointSymbol(1, 1, 5)));
     /**
      * **Viewpoint Numbers count visible cells in the four directions**
      * @param x - The x-coordinate of the symbol.
@@ -12,12 +37,6 @@ class ViewpointSymbol extends NumberSymbol {
      */
     constructor(x, y, number) {
         super(x, y, number);
-        Object.defineProperty(this, "title", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 'Viewpoint Number'
-        });
     }
     get id() {
         return `viewpoint`;
@@ -73,39 +92,4 @@ class ViewpointSymbol extends NumberSymbol {
         return this.copyWith({ number });
     }
 }
-Object.defineProperty(ViewpointSymbol, "CONFIGS", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: Object.freeze([
-        {
-            type: ConfigType.Number,
-            default: 0,
-            field: 'x',
-            description: 'X',
-            configurable: false,
-        },
-        {
-            type: ConfigType.Number,
-            default: 0,
-            field: 'y',
-            description: 'Y',
-            configurable: false,
-        },
-        {
-            type: ConfigType.Number,
-            default: 1,
-            field: 'number',
-            description: 'Number',
-            configurable: true,
-        },
-    ])
-});
-Object.defineProperty(ViewpointSymbol, "EXAMPLE_GRID", {
-    enumerable: true,
-    configurable: true,
-    writable: true,
-    value: Object.freeze(GridData.create(['bbbbb', 'wwwwb', 'bwwbb', 'bbwww']).addSymbol(new ViewpointSymbol(1, 1, 5)))
-});
-export default ViewpointSymbol;
 export const instance = new ViewpointSymbol(0, 0, 1);

package/dist/{data → src/data}/tile.js

@@ -1,24 +1,12 @@
 import { Color } from './primitives.js';
 export default class TileData {
+    exists;
+    fixed;
+    color;
     constructor(exists, fixed, color) {
-        Object.defineProperty(this, "exists", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: exists
-        });
-        Object.defineProperty(this, "fixed", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: fixed
-        });
-        Object.defineProperty(this, "color", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: color
-        });
+        this.exists = exists;
+        this.fixed = fixed;
+        this.color = color;
         this.exists = exists;
         this.fixed = fixed;
         this.color = color;

package/dist/src/data/validateAsync.js

@@ -0,0 +1,71 @@
+import debounce from 'lodash/debounce.js';
+import { Serializer } from './serializer/allSerializers.js';
+import validateGrid from './validate.js';
+const SYNC_VALIDATION_THRESHOLD = 10000;
+export class GridValidator {
+    worker = null;
+    stateListeners = new Set();
+    loadListeners = new Set();
+    validateGridDebounced = debounce((grid, solution) => {
+        this.worker?.terminate();
+        this.worker = new Worker(new URL('./validateAsyncWorker.js', import.meta.url), { type: 'module' });
+        this.worker.onmessage = (event) => {
+            if (event.data) {
+                this.notifyState(event.data);
+            }
+            this.worker?.terminate();
+            this.worker = null;
+            this.notifyLoad();
+        };
+        this.worker.onmessageerror = (error) => {
+            console.error('Validation worker error:', error);
+            this.worker?.terminate();
+            this.worker = null;
+            this.notifyLoad();
+        };
+        this.worker.postMessage({
+            grid: Serializer.stringifyGrid(grid),
+            solution: solution ? Serializer.stringifyGrid(solution) : null,
+        });
+        this.notifyLoad();
+    }, 300, { leading: true, trailing: true });
+    validateGrid = (grid, solution) => {
+        if (grid.width * grid.height <= SYNC_VALIDATION_THRESHOLD) {
+            // Synchronous validation for small grids
+            // to avoid the overhead of worker communication.
+            const state = validateGrid(grid, solution);
+            this.notifyState(state);
+        }
+        else {
+            this.validateGridDebounced(grid, solution);
+        }
+    };
+    notifyState = (state) => {
+        this.stateListeners.forEach(listener => listener(state));
+    };
+    subscribeToState = (listener) => {
+        this.stateListeners.add(listener);
+        return () => {
+            this.stateListeners.delete(listener);
+        };
+    };
+    notifyLoad = () => {
+        this.loadListeners.forEach(listener => listener());
+    };
+    subscribeToLoad = (listener) => {
+        this.loadListeners.add(listener);
+        return () => {
+            this.loadListeners.delete(listener);
+        };
+    };
+    isLoading = () => {
+        return this.worker !== null;
+    };
+    delete = () => {
+        if (this.worker) {
+            this.worker.terminate();
+            this.worker = null;
+        }
+        this.stateListeners.clear();
+    };
+}

package/dist/src/data/validateAsyncWorker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/{index.d.ts → src/index.d.ts}

@@ -32,6 +32,7 @@ import LyingSymbolRule from './data/rules/lyingSymbolRule.js';
 import { ControlLine, Row } from './data/rules/musicControlLine.js';
 import MusicGridRule from './data/rules/musicGridRule.js';
 import MysteryRule from './data/rules/mysteryRule.js';
+import NoLoopsRule from './data/rules/noLoopsRule.js';
 import OffByXRule from './data/rules/offByXRule.js';
 import PerfectionRule from './data/rules/perfectionRule.js';
 import RegionAreaRule from './data/rules/regionAreaRule.js';
@@ -117,4 +118,4 @@ import TileData from './data/tile.js';
 import TileConnections from './data/tileConnections.js';
 import validateGrid, { aggregateState, applyFinalOverrides } from './data/validate.js';
 import { GridValidator } from './data/validateAsync.js';
-export { ConfigType, configEquals, Configurable, CachedAccess, allEqual, array, directionToRotation, escape, isSameEdge, maxBy, minBy, move, orientationToRotation, resize, unescape, isEventHandler, handlesFinalValidation, handlesGetTile, handlesGridChange, handlesGridResize, handlesSetGrid, invokeSetGrid, handlesSymbolDisplay, handlesSymbolMerge, handlesSymbolValidation, GridData, NEIGHBOR_OFFSETS, GridConnections, GridZones, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, DRUM_SAMPLES, Direction, INSTRUMENTS, Instrument, MajorRule, Mode, ORIENTATIONS, Orientation, PuzzleType, State, WRAPPINGS, Wrapping, directionToggle, isDrumSample, orientationToggle, MetadataSchema, PuzzleSchema, getPuzzleTypes, puzzleEquals, validatePuzzleChecklist, BanPatternRule, CellCountPerZoneRule, CellCountRule, CompletePatternRule, ConnectAllRule, ConnectZonesRule, ContainsShapeRule, CustomRule, DifferentCountPerZoneRule, ExactCountPerZoneRule, ForesightRule, allRules, LyingSymbolRule, ControlLine, Row, MusicGridRule, MysteryRule, OffByXRule, PerfectionRule, RegionAreaRule, RegionShapeRule, Rule, SameCountPerZoneRule, SameShapeRule, SymbolsPerRegionRule, UndercluedRule, UniqueShapeRule, WrapAroundRule, Serializer, Compressor, ChecksumCompressor, CompressorBase, DeflateCompressor, GzipCompressor, StreamCompressor, SerializerBase, SerializerChecksum, SerializerV0, OFFSETS, orientationChars, getShapeVariants, normalizeShape, positionsToShape, sanitizePatternGrid, shapeEquals, tilesToShape, allSolvers, AutoSolver, BacktrackSolver, BTModule, BTGridData, BTTile, IntArray2D, colorToBTTile, createOneTileResult, getOppositeColor, BanPatternBTModule, CellCountBTModule, ConnectAllBTModule, RegionAreaBTModule, RegionShapeBTModule, SameShapeBTModule, SymbolsPerRegionBTModule, UniqueShapeBTModule, AreaNumberBTModule, DartBTModule, DirectionLinkerBTModule, FocusBTModule, GalaxyBTModule, LetterBTModule, LotusBTModule, MinesweeperBTModule, MyopiaBTModule, ViewpointBTModule, CspuzSolver, gridToJson, EventIteratingSolver, Solver, UniversalSolver, AreaNumberModule, CellCountModule, ConnectAllModule, DartModule, allZ3Modules, LetterModule, MyopiaModule, RegionAreaModule, ViewpointModule, Z3Module, convertDirection, Z3Solver, Z3SolverContext, AreaNumberSymbol, CustomIconSymbol, CustomSymbol, CustomTextSymbol, DartSymbol, DirectionLinkerSymbol, EveryLetterSymbol, FocusSymbol, GalaxySymbol, HiddenSymbol, HouseSymbol, allSymbols, LetterSymbol, LotusSymbol, MinesweeperSymbol, MyopiaSymbol, NumberSymbol, Symbol, ViewpointSymbol, TileData, TileConnections, validateGrid, aggregateState, applyFinalOverrides, GridValidator, };
+export { ConfigType, configEquals, Configurable, CachedAccess, allEqual, array, directionToRotation, escape, isSameEdge, maxBy, minBy, move, orientationToRotation, resize, unescape, isEventHandler, handlesFinalValidation, handlesGetTile, handlesGridChange, handlesGridResize, handlesSetGrid, invokeSetGrid, handlesSymbolDisplay, handlesSymbolMerge, handlesSymbolValidation, GridData, NEIGHBOR_OFFSETS, GridConnections, GridZones, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, DRUM_SAMPLES, Direction, INSTRUMENTS, Instrument, MajorRule, Mode, ORIENTATIONS, Orientation, PuzzleType, State, WRAPPINGS, Wrapping, directionToggle, isDrumSample, orientationToggle, MetadataSchema, PuzzleSchema, getPuzzleTypes, puzzleEquals, validatePuzzleChecklist, BanPatternRule, CellCountPerZoneRule, CellCountRule, CompletePatternRule, ConnectAllRule, ConnectZonesRule, ContainsShapeRule, CustomRule, DifferentCountPerZoneRule, ExactCountPerZoneRule, ForesightRule, allRules, LyingSymbolRule, ControlLine, Row, MusicGridRule, MysteryRule, NoLoopsRule, OffByXRule, PerfectionRule, RegionAreaRule, RegionShapeRule, Rule, SameCountPerZoneRule, SameShapeRule, SymbolsPerRegionRule, UndercluedRule, UniqueShapeRule, WrapAroundRule, Serializer, Compressor, ChecksumCompressor, CompressorBase, DeflateCompressor, GzipCompressor, StreamCompressor, SerializerBase, SerializerChecksum, SerializerV0, OFFSETS, orientationChars, getShapeVariants, normalizeShape, positionsToShape, sanitizePatternGrid, shapeEquals, tilesToShape, allSolvers, AutoSolver, BacktrackSolver, BTModule, BTGridData, BTTile, IntArray2D, colorToBTTile, createOneTileResult, getOppositeColor, BanPatternBTModule, CellCountBTModule, ConnectAllBTModule, RegionAreaBTModule, RegionShapeBTModule, SameShapeBTModule, SymbolsPerRegionBTModule, UniqueShapeBTModule, AreaNumberBTModule, DartBTModule, DirectionLinkerBTModule, FocusBTModule, GalaxyBTModule, LetterBTModule, LotusBTModule, MinesweeperBTModule, MyopiaBTModule, ViewpointBTModule, CspuzSolver, gridToJson, EventIteratingSolver, Solver, UniversalSolver, AreaNumberModule, CellCountModule, ConnectAllModule, DartModule, allZ3Modules, LetterModule, MyopiaModule, RegionAreaModule, ViewpointModule, Z3Module, convertDirection, Z3Solver, Z3SolverContext, AreaNumberSymbol, CustomIconSymbol, CustomSymbol, CustomTextSymbol, DartSymbol, DirectionLinkerSymbol, EveryLetterSymbol, FocusSymbol, GalaxySymbol, HiddenSymbol, HouseSymbol, allSymbols, LetterSymbol, LotusSymbol, MinesweeperSymbol, MyopiaSymbol, NumberSymbol, Symbol, ViewpointSymbol, TileData, TileConnections, validateGrid, aggregateState, applyFinalOverrides, GridValidator, };

package/dist/{index.js → src/index.js}

@@ -35,6 +35,7 @@ import LyingSymbolRule from './data/rules/lyingSymbolRule.js';
 import { ControlLine, Row } from './data/rules/musicControlLine.js';
 import MusicGridRule from './data/rules/musicGridRule.js';
 import MysteryRule from './data/rules/mysteryRule.js';
+import NoLoopsRule from './data/rules/noLoopsRule.js';
 import OffByXRule from './data/rules/offByXRule.js';
 import PerfectionRule from './data/rules/perfectionRule.js';
 import RegionAreaRule from './data/rules/regionAreaRule.js';
@@ -120,4 +121,4 @@ import TileData from './data/tile.js';
 import TileConnections from './data/tileConnections.js';
 import validateGrid, { aggregateState, applyFinalOverrides } from './data/validate.js';
 import { GridValidator } from './data/validateAsync.js';
-export { ConfigType, configEquals, Configurable, CachedAccess, allEqual, array, directionToRotation, escape, isSameEdge, maxBy, minBy, move, orientationToRotation, resize, unescape, isEventHandler, handlesFinalValidation, handlesGetTile, handlesGridChange, handlesGridResize, handlesSetGrid, invokeSetGrid, handlesSymbolDisplay, handlesSymbolMerge, handlesSymbolValidation, GridData, NEIGHBOR_OFFSETS, GridConnections, GridZones, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, DRUM_SAMPLES, Direction, INSTRUMENTS, Instrument, MajorRule, Mode, ORIENTATIONS, Orientation, PuzzleType, State, WRAPPINGS, Wrapping, directionToggle, isDrumSample, orientationToggle, MetadataSchema, PuzzleSchema, getPuzzleTypes, puzzleEquals, validatePuzzleChecklist, BanPatternRule, CellCountPerZoneRule, CellCountRule, CompletePatternRule, ConnectAllRule, ConnectZonesRule, ContainsShapeRule, CustomRule, DifferentCountPerZoneRule, ExactCountPerZoneRule, ForesightRule, allRules, LyingSymbolRule, ControlLine, Row, MusicGridRule, MysteryRule, OffByXRule, PerfectionRule, RegionAreaRule, RegionShapeRule, Rule, SameCountPerZoneRule, SameShapeRule, SymbolsPerRegionRule, UndercluedRule, UniqueShapeRule, WrapAroundRule, Serializer, Compressor, ChecksumCompressor, CompressorBase, DeflateCompressor, GzipCompressor, StreamCompressor, SerializerBase, SerializerChecksum, SerializerV0, OFFSETS, orientationChars, getShapeVariants, normalizeShape, positionsToShape, sanitizePatternGrid, shapeEquals, tilesToShape, allSolvers, AutoSolver, BacktrackSolver, BTModule, BTGridData, BTTile, IntArray2D, colorToBTTile, createOneTileResult, getOppositeColor, BanPatternBTModule, CellCountBTModule, ConnectAllBTModule, RegionAreaBTModule, RegionShapeBTModule, SameShapeBTModule, SymbolsPerRegionBTModule, UniqueShapeBTModule, AreaNumberBTModule, DartBTModule, DirectionLinkerBTModule, FocusBTModule, GalaxyBTModule, LetterBTModule, LotusBTModule, MinesweeperBTModule, MyopiaBTModule, ViewpointBTModule, CspuzSolver, gridToJson, EventIteratingSolver, Solver, UniversalSolver, AreaNumberModule, CellCountModule, ConnectAllModule, DartModule, allZ3Modules, LetterModule, MyopiaModule, RegionAreaModule, ViewpointModule, Z3Module, convertDirection, Z3Solver, Z3SolverContext, AreaNumberSymbol, CustomIconSymbol, CustomSymbol, CustomTextSymbol, DartSymbol, DirectionLinkerSymbol, EveryLetterSymbol, FocusSymbol, GalaxySymbol, HiddenSymbol, HouseSymbol, allSymbols, LetterSymbol, LotusSymbol, MinesweeperSymbol, MyopiaSymbol, NumberSymbol, Symbol, ViewpointSymbol, TileData, TileConnections, validateGrid, aggregateState, applyFinalOverrides, GridValidator, };
+export { ConfigType, configEquals, Configurable, CachedAccess, allEqual, array, directionToRotation, escape, isSameEdge, maxBy, minBy, move, orientationToRotation, resize, unescape, isEventHandler, handlesFinalValidation, handlesGetTile, handlesGridChange, handlesGridResize, handlesSetGrid, invokeSetGrid, handlesSymbolDisplay, handlesSymbolMerge, handlesSymbolValidation, GridData, NEIGHBOR_OFFSETS, GridConnections, GridZones, Instruction, COMPARISONS, Color, Comparison, DIRECTIONS, DRUM_SAMPLES, Direction, INSTRUMENTS, Instrument, MajorRule, Mode, ORIENTATIONS, Orientation, PuzzleType, State, WRAPPINGS, Wrapping, directionToggle, isDrumSample, orientationToggle, MetadataSchema, PuzzleSchema, getPuzzleTypes, puzzleEquals, validatePuzzleChecklist, BanPatternRule, CellCountPerZoneRule, CellCountRule, CompletePatternRule, ConnectAllRule, ConnectZonesRule, ContainsShapeRule, CustomRule, DifferentCountPerZoneRule, ExactCountPerZoneRule, ForesightRule, allRules, LyingSymbolRule, ControlLine, Row, MusicGridRule, MysteryRule, NoLoopsRule, OffByXRule, PerfectionRule, RegionAreaRule, RegionShapeRule, Rule, SameCountPerZoneRule, SameShapeRule, SymbolsPerRegionRule, UndercluedRule, UniqueShapeRule, WrapAroundRule, Serializer, Compressor, ChecksumCompressor, CompressorBase, DeflateCompressor, GzipCompressor, StreamCompressor, SerializerBase, SerializerChecksum, SerializerV0, OFFSETS, orientationChars, getShapeVariants, normalizeShape, positionsToShape, sanitizePatternGrid, shapeEquals, tilesToShape, allSolvers, AutoSolver, BacktrackSolver, BTModule, BTGridData, BTTile, IntArray2D, colorToBTTile, createOneTileResult, getOppositeColor, BanPatternBTModule, CellCountBTModule, ConnectAllBTModule, RegionAreaBTModule, RegionShapeBTModule, SameShapeBTModule, SymbolsPerRegionBTModule, UniqueShapeBTModule, AreaNumberBTModule, DartBTModule, DirectionLinkerBTModule, FocusBTModule, GalaxyBTModule, LetterBTModule, LotusBTModule, MinesweeperBTModule, MyopiaBTModule, ViewpointBTModule, CspuzSolver, gridToJson, EventIteratingSolver, Solver, UniversalSolver, AreaNumberModule, CellCountModule, ConnectAllModule, DartModule, allZ3Modules, LetterModule, MyopiaModule, RegionAreaModule, ViewpointModule, Z3Module, convertDirection, Z3Solver, Z3SolverContext, AreaNumberSymbol, CustomIconSymbol, CustomSymbol, CustomTextSymbol, DartSymbol, DirectionLinkerSymbol, EveryLetterSymbol, FocusSymbol, GalaxySymbol, HiddenSymbol, HouseSymbol, allSymbols, LetterSymbol, LotusSymbol, MinesweeperSymbol, MyopiaSymbol, NumberSymbol, Symbol, ViewpointSymbol, TileData, TileConnections, validateGrid, aggregateState, applyFinalOverrides, GridValidator, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@logic-pad/core",
-  "version": "0.24.0",
+  "version": "0.25.1",
   "type": "module",
   "files": [
     "dist",
@@ -20,20 +20,19 @@
     "grid"
   ],
   "license": "AGPL-3.0-only",
-  "main": "./dist/logic-core.umd.cjs",
-  "module": "./dist/logic-core.js",
+  "module": "./dist/src/index.js",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
+      "import": "./dist/src/index.js",
+      "require": "./dist/src/index.js"
     },
     "./data/*": {
-      "import": "./dist/data/*",
-      "require": "./dist/data/*"
+      "import": "./dist/src/data/*",
+      "require": "./dist/src/data/*"
     },
     "./polyfill/*": {
-      "import": "./dist/polyfill/*",
-      "require": "./dist/polyfill/*"
+      "import": "./dist/src/polyfill/*",
+      "require": "./dist/src/polyfill/*"
     },
     "./assets/*": {
       "import": "./assets/*",
@@ -44,6 +43,8 @@
     "build": "rimraf dist/ && bun run codegen && bunx --bun tsc && bun run typegen",
     "codegen": "bun ./scripts/genImports.ts && bun ./scripts/genEntry.ts",
     "typegen": "bun ./scripts/genTypes.ts",
+    "bench:prepare": "bun ./benchmark/prepareBench.ts",
+    "bench:run": "bun ./benchmark/runBench.ts",
     "prepublishOnly": "bun run build"
   },
   "engines": {
@@ -65,9 +66,11 @@
     "@types/lodash": "^4.17.20",
     "dts-bundle-generator": "^9.5.1",
     "fast-glob": "^3.3.3",
+    "p-queue": "^9.0.1",
     "prettier": "^3.6.2",
     "rimraf": "^6.0.1",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.2",
+    "uint8-to-base64": "^0.2.1"
   },
   "trustedDependencies": [
     "esbuild"

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

@@ -1,38 +0,0 @@
-import { instance as undercluedInstance } from '../../rules/undercluedRule.js';
-import EventIteratingSolver from '../eventIteratingSolver.js';
-// eslint-disable-next-line @typescript-eslint/no-unused-expressions
-('vite-apply-code-mod');
-export default class UniversalSolver extends EventIteratingSolver {
-    constructor() {
-        super(...arguments);
-        Object.defineProperty(this, "id", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 'universal'
-        });
-        Object.defineProperty(this, "author", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 'romain22222, Lysine'
-        });
-        Object.defineProperty(this, "description", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 'A backtracking solver that supports all rules and symbols (including underclued) but is less optimized.'
-        });
-    }
-    createWorker() {
-        return new Worker(new URL('./universalWorker.js', import.meta.url), {
-            type: 'module',
-        });
-    }
-    isInstructionSupported(instructionId) {
-        if (super.isInstructionSupported(instructionId)) {
-            return true;
-        }
-        return instructionId === undercluedInstance.id;
-    }
-}

package/dist/data/validateAsync.js

@@ -1,128 +0,0 @@
-import debounce from 'lodash/debounce.js';
-import { Serializer } from './serializer/allSerializers.js';
-import validateGrid from './validate.js';
-const SYNC_VALIDATION_THRESHOLD = 10000;
-export class GridValidator {
-    constructor() {
-        Object.defineProperty(this, "worker", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: null
-        });
-        Object.defineProperty(this, "stateListeners", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Set()
-        });
-        Object.defineProperty(this, "loadListeners", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: new Set()
-        });
-        Object.defineProperty(this, "validateGridDebounced", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: debounce((grid, solution) => {
-                this.worker?.terminate();
-                this.worker = new Worker(new URL('./validateAsyncWorker.js', import.meta.url), { type: 'module' });
-                this.worker.onmessage = (event) => {
-                    if (event.data) {
-                        this.notifyState(event.data);
-                    }
-                    this.worker?.terminate();
-                    this.worker = null;
-                    this.notifyLoad();
-                };
-                this.worker.onmessageerror = (error) => {
-                    console.error('Validation worker error:', error);
-                    this.worker?.terminate();
-                    this.worker = null;
-                    this.notifyLoad();
-                };
-                this.worker.postMessage({
-                    grid: Serializer.stringifyGrid(grid),
-                    solution: solution ? Serializer.stringifyGrid(solution) : null,
-                });
-                this.notifyLoad();
-            }, 300, { leading: true, trailing: true })
-        });
-        Object.defineProperty(this, "validateGrid", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: (grid, solution) => {
-                if (grid.width * grid.height <= SYNC_VALIDATION_THRESHOLD) {
-                    // Synchronous validation for small grids
-                    // to avoid the overhead of worker communication.
-                    const state = validateGrid(grid, solution);
-                    this.notifyState(state);
-                }
-                else {
-                    this.validateGridDebounced(grid, solution);
-                }
-            }
-        });
-        Object.defineProperty(this, "notifyState", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: (state) => {
-                this.stateListeners.forEach(listener => listener(state));
-            }
-        });
-        Object.defineProperty(this, "subscribeToState", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: (listener) => {
-                this.stateListeners.add(listener);
-                return () => {
-                    this.stateListeners.delete(listener);
-                };
-            }
-        });
-        Object.defineProperty(this, "notifyLoad", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: () => {
-                this.loadListeners.forEach(listener => listener());
-            }
-        });
-        Object.defineProperty(this, "subscribeToLoad", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: (listener) => {
-                this.loadListeners.add(listener);
-                return () => {
-                    this.loadListeners.delete(listener);
-                };
-            }
-        });
-        Object.defineProperty(this, "isLoading", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: () => {
-                return this.worker !== null;
-            }
-        });
-        Object.defineProperty(this, "delete", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: () => {
-                if (this.worker) {
-                    this.worker.terminate();
-                    this.worker = null;
-                }
-                this.stateListeners.clear();
-            }
-        });
-    }
-}