@sudobility/sudojo_lib 0.0.38 → 0.0.41
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/types/game.d.ts +2 -36
- package/dist/types/game.d.ts.map +1 -1
- package/dist/types/game.js +1 -12
- package/dist/types/game.js.map +1 -1
- package/dist/utils/board.d.ts +1 -18
- package/dist/utils/board.d.ts.map +1 -1
- package/dist/utils/board.js +4 -58
- package/dist/utils/board.js.map +1 -1
- package/dist/utils/scramble.d.ts +3 -30
- package/dist/utils/scramble.d.ts.map +1 -1
- package/dist/utils/scramble.js +4 -265
- package/dist/utils/scramble.js.map +1 -1
- package/dist/utils/technique.js +1 -1
- package/dist/utils/technique.js.map +1 -1
- package/package.json +5 -5
package/dist/types/game.d.ts
CHANGED
|
@@ -123,42 +123,8 @@ export interface CellPosition {
|
|
|
123
123
|
row: number;
|
|
124
124
|
column: number;
|
|
125
125
|
}
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
*/
|
|
129
|
-
export interface ScrambleConfig {
|
|
130
|
-
/** Whether to scramble rows within blocks */
|
|
131
|
-
scrambleRows: boolean;
|
|
132
|
-
/** Whether to scramble columns within blocks */
|
|
133
|
-
scrambleColumns: boolean;
|
|
134
|
-
/** Whether to scramble row blocks (groups of 3 rows) */
|
|
135
|
-
scrambleRowBlocks: boolean;
|
|
136
|
-
/** Whether to scramble column blocks (groups of 3 columns) */
|
|
137
|
-
scrambleColumnBlocks: boolean;
|
|
138
|
-
/** Whether to scramble digit mapping (1-9 -> 1-9) */
|
|
139
|
-
scrambleDigits: boolean;
|
|
140
|
-
/** Whether to rotate the board (0, 90, 180, 270 degrees) */
|
|
141
|
-
rotate: boolean;
|
|
142
|
-
/** Whether to mirror the board */
|
|
143
|
-
mirror: boolean;
|
|
144
|
-
}
|
|
145
|
-
/**
|
|
146
|
-
* Default scramble configuration (all enabled)
|
|
147
|
-
*/
|
|
148
|
-
export declare const DEFAULT_SCRAMBLE_CONFIG: ScrambleConfig;
|
|
149
|
-
/**
|
|
150
|
-
* Result of scrambling a board
|
|
151
|
-
*/
|
|
152
|
-
export interface ScrambleResult {
|
|
153
|
-
/** The scrambled puzzle string */
|
|
154
|
-
puzzle: string;
|
|
155
|
-
/** The scrambled solution string */
|
|
156
|
-
solution: string;
|
|
157
|
-
/** The digit mapping used (original -> scrambled) */
|
|
158
|
-
digitMapping: Map<number, number>;
|
|
159
|
-
/** The reverse digit mapping (scrambled -> original) */
|
|
160
|
-
reverseDigitMapping: Map<number, number>;
|
|
161
|
-
}
|
|
126
|
+
export type { ScrambleConfig, ScrambleResult } from '@sudobility/sudojo_types';
|
|
127
|
+
export { DEFAULT_SCRAMBLE_CONFIG } from '@sudobility/sudojo_types';
|
|
162
128
|
/**
|
|
163
129
|
* Hint information from the solver
|
|
164
130
|
*/
|
package/dist/types/game.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../src/types/game.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../src/types/game.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,mDAAmD;IACnD,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,wEAAwE;IACxE,aAAa,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,EAAE,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2BAA2B;IAC3B,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,sBAAsB;IACtB,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,mBAAmB;IACnB,IAAI,EAAE,OAAO,GAAG,YAAY,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,UAAU,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,8DAA8D;IAC9D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,8DAA8D;IAC9D,qBAAqB,EAAE,OAAO,CAAC;IAC/B,sCAAsC;IACtC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAMnC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,UAAU,GACV,SAAS,GACT,QAAQ,GACR,WAAW,GACX,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,8BAA8B;IAC9B,KAAK,EAAE,SAAS,CAAC;IACjB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,iBAAiB;IACjB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,iBAAiB;IACjB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,uCAAuC;IACvC,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrD,oBAAoB;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,0BAA0B;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gEAAgE;IAChE,QAAQ,EAAE,OAAO,CAAC;IAClB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAGD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,KAAK,EAAE,KAAK,CAAC;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE;YACP,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;YAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;SAC9B,CAAC;KACH,CAAC,CAAC;IACH,6CAA6C;IAC7C,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;QACjC,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,+BAA+B;IAC/B,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC7B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB"}
|
package/dist/types/game.js
CHANGED
|
@@ -11,16 +11,5 @@ export const DEFAULT_GAME_SETTINGS = {
|
|
|
11
11
|
autoRemovePencilmarks: true,
|
|
12
12
|
autoPencilmarks: false,
|
|
13
13
|
};
|
|
14
|
-
|
|
15
|
-
* Default scramble configuration (all enabled)
|
|
16
|
-
*/
|
|
17
|
-
export const DEFAULT_SCRAMBLE_CONFIG = {
|
|
18
|
-
scrambleRows: true,
|
|
19
|
-
scrambleColumns: true,
|
|
20
|
-
scrambleRowBlocks: true,
|
|
21
|
-
scrambleColumnBlocks: true,
|
|
22
|
-
scrambleDigits: true,
|
|
23
|
-
rotate: true,
|
|
24
|
-
mirror: true,
|
|
25
|
-
};
|
|
14
|
+
export { DEFAULT_SCRAMBLE_CONFIG } from '@sudobility/sudojo_types';
|
|
26
15
|
//# sourceMappingURL=game.js.map
|
package/dist/types/game.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"game.js","sourceRoot":"","sources":["../../src/types/game.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,UAAU,EAAE,IAAI;IAChB,oBAAoB,EAAE,IAAI;IAC1B,qBAAqB,EAAE,IAAI;IAC3B,qBAAqB,EAAE,IAAI;IAC3B,eAAe,EAAE,KAAK;CACvB,CAAC;
|
|
1
|
+
{"version":3,"file":"game.js","sourceRoot":"","sources":["../../src/types/game.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,UAAU,EAAE,IAAI;IAChB,oBAAoB,EAAE,IAAI;IAC1B,qBAAqB,EAAE,IAAI;IAC3B,qBAAqB,EAAE,IAAI;IAC3B,eAAe,EAAE,KAAK;CACvB,CAAC;AAoEF,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}
|
package/dist/utils/board.d.ts
CHANGED
|
@@ -2,24 +2,7 @@
|
|
|
2
2
|
* Board utilities for parsing, stringifying, and manipulating Sudoku boards
|
|
3
3
|
*/
|
|
4
4
|
import type { GameBoard } from '../types';
|
|
5
|
-
|
|
6
|
-
* Board size constants
|
|
7
|
-
*/
|
|
8
|
-
export declare const BOARD_SIZE = 9;
|
|
9
|
-
export declare const BLOCK_SIZE = 3;
|
|
10
|
-
export declare const TOTAL_CELLS: number;
|
|
11
|
-
/**
|
|
12
|
-
* Parses an 81-character board string into a 2D array of numbers
|
|
13
|
-
* @param boardString - 81-character string where '0' or '.' represents empty cells
|
|
14
|
-
* @returns 9x9 array of numbers (0 = empty, 1-9 = filled)
|
|
15
|
-
*/
|
|
16
|
-
export declare function parseBoardString(boardString: string): number[][];
|
|
17
|
-
/**
|
|
18
|
-
* Converts a 2D number array back to an 81-character string
|
|
19
|
-
* @param board - 9x9 array of numbers
|
|
20
|
-
* @returns 81-character string
|
|
21
|
-
*/
|
|
22
|
-
export declare function stringifyBoard(board: number[][]): string;
|
|
5
|
+
export { BOARD_SIZE, BLOCK_SIZE, TOTAL_CELLS, parseBoardString, stringifyBoard, } from '@sudobility/sudojo_types';
|
|
23
6
|
/**
|
|
24
7
|
* Creates an initial GameBoard from puzzle and solution strings
|
|
25
8
|
* @param puzzle - 81-character puzzle string
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/utils/board.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../src/utils/board.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAa,SAAS,EAAE,MAAM,UAAU,CAAC;AAGrD,OAAO,EACL,UAAU,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,GACf,MAAM,0BAA0B,CAAC;AASlC;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CA0B3E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAc7D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAMxC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAMxC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAaxC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BxC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CA+BT;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAOtD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,GACf,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAUxC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAUzD"}
|
package/dist/utils/board.js
CHANGED
|
@@ -1,64 +1,10 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Board utilities for parsing, stringifying, and manipulating Sudoku boards
|
|
3
3
|
*/
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
export const BLOCK_SIZE = 3;
|
|
9
|
-
export const TOTAL_CELLS = BOARD_SIZE * BOARD_SIZE;
|
|
10
|
-
/**
|
|
11
|
-
* Parses an 81-character board string into a 2D array of numbers
|
|
12
|
-
* @param boardString - 81-character string where '0' or '.' represents empty cells
|
|
13
|
-
* @returns 9x9 array of numbers (0 = empty, 1-9 = filled)
|
|
14
|
-
*/
|
|
15
|
-
export function parseBoardString(boardString) {
|
|
16
|
-
if (boardString.length !== TOTAL_CELLS) {
|
|
17
|
-
throw new Error(`Invalid board string length: expected ${TOTAL_CELLS}, got ${boardString.length}`);
|
|
18
|
-
}
|
|
19
|
-
const board = [];
|
|
20
|
-
for (let row = 0; row < BOARD_SIZE; row++) {
|
|
21
|
-
const rowArray = [];
|
|
22
|
-
for (let col = 0; col < BOARD_SIZE; col++) {
|
|
23
|
-
const index = row * BOARD_SIZE + col;
|
|
24
|
-
const char = boardString[index];
|
|
25
|
-
if (char === undefined) {
|
|
26
|
-
throw new Error(`Missing character at position ${index}`);
|
|
27
|
-
}
|
|
28
|
-
const value = char === '.' ? 0 : parseInt(char, 10);
|
|
29
|
-
if (isNaN(value) || value < 0 || value > 9) {
|
|
30
|
-
throw new Error(`Invalid character at position ${index}: '${char}'`);
|
|
31
|
-
}
|
|
32
|
-
rowArray.push(value);
|
|
33
|
-
}
|
|
34
|
-
board.push(rowArray);
|
|
35
|
-
}
|
|
36
|
-
return board;
|
|
37
|
-
}
|
|
38
|
-
/**
|
|
39
|
-
* Converts a 2D number array back to an 81-character string
|
|
40
|
-
* @param board - 9x9 array of numbers
|
|
41
|
-
* @returns 81-character string
|
|
42
|
-
*/
|
|
43
|
-
export function stringifyBoard(board) {
|
|
44
|
-
if (board.length !== BOARD_SIZE) {
|
|
45
|
-
throw new Error(`Invalid board rows: expected ${BOARD_SIZE}, got ${board.length}`);
|
|
46
|
-
}
|
|
47
|
-
let result = '';
|
|
48
|
-
for (let row = 0; row < BOARD_SIZE; row++) {
|
|
49
|
-
if (board[row]?.length !== BOARD_SIZE) {
|
|
50
|
-
throw new Error(`Invalid row ${row} length: expected ${BOARD_SIZE}, got ${board[row]?.length}`);
|
|
51
|
-
}
|
|
52
|
-
for (let col = 0; col < BOARD_SIZE; col++) {
|
|
53
|
-
const value = board[row]?.[col];
|
|
54
|
-
if (value === undefined || value < 0 || value > 9) {
|
|
55
|
-
throw new Error(`Invalid value at (${row}, ${col}): ${value}`);
|
|
56
|
-
}
|
|
57
|
-
result += value.toString();
|
|
58
|
-
}
|
|
59
|
-
}
|
|
60
|
-
return result;
|
|
61
|
-
}
|
|
4
|
+
// Re-export board constants and basic utilities from sudojo_types
|
|
5
|
+
export { BOARD_SIZE, BLOCK_SIZE, TOTAL_CELLS, parseBoardString, stringifyBoard, } from '@sudobility/sudojo_types';
|
|
6
|
+
// Import for local use
|
|
7
|
+
import { BLOCK_SIZE, BOARD_SIZE, parseBoardString, } from '@sudobility/sudojo_types';
|
|
62
8
|
/**
|
|
63
9
|
* Creates an initial GameBoard from puzzle and solution strings
|
|
64
10
|
* @param puzzle - 81-character puzzle string
|
package/dist/utils/board.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/utils/board.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH
|
|
1
|
+
{"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/utils/board.ts"],"names":[],"mappings":"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"}
|
package/dist/utils/scramble.d.ts
CHANGED
|
@@ -1,35 +1,8 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Board scrambling utilities for creating visually different but equivalent puzzles
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
* - Preventing players from recognizing puzzles they've seen before
|
|
7
|
-
* - Creating variety from a limited puzzle database
|
|
8
|
-
* - Making it harder to look up solutions online
|
|
4
|
+
* Re-exports scramble functions from @sudobility/sudojo_types for backwards compatibility.
|
|
5
|
+
* The implementation has been moved to sudojo_types to allow sharing between frontend and backend.
|
|
9
6
|
*/
|
|
10
|
-
|
|
11
|
-
/**
|
|
12
|
-
* Scrambles a Sudoku board while preserving its logical structure
|
|
13
|
-
*
|
|
14
|
-
* @param puzzle - 81-character puzzle string
|
|
15
|
-
* @param solution - 81-character solution string
|
|
16
|
-
* @param config - Scramble configuration (defaults to all transformations enabled)
|
|
17
|
-
* @returns Scramble result with scrambled puzzle, solution, and digit mapping
|
|
18
|
-
*
|
|
19
|
-
* @example
|
|
20
|
-
* ```typescript
|
|
21
|
-
* const result = scrambleBoard(puzzle, solution);
|
|
22
|
-
* console.log(result.puzzle); // Scrambled puzzle
|
|
23
|
-
* console.log(result.solution); // Scrambled solution
|
|
24
|
-
* console.log(result.digitMapping); // Map from original to scrambled digits
|
|
25
|
-
* ```
|
|
26
|
-
*/
|
|
27
|
-
export declare function scrambleBoard(puzzle: string, solution: string, config?: ScrambleConfig): ScrambleResult;
|
|
28
|
-
/**
|
|
29
|
-
* Creates an identity scramble result (no scrambling)
|
|
30
|
-
* @param puzzle - 81-character puzzle string
|
|
31
|
-
* @param solution - 81-character solution string
|
|
32
|
-
* @returns ScrambleResult with identity mapping
|
|
33
|
-
*/
|
|
34
|
-
export declare function noScramble(puzzle: string, solution: string): ScrambleResult;
|
|
7
|
+
export { scrambleBoard, noScramble } from '@sudobility/sudojo_types';
|
|
35
8
|
//# sourceMappingURL=scramble.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scramble.d.ts","sourceRoot":"","sources":["../../src/utils/scramble.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"scramble.d.ts","sourceRoot":"","sources":["../../src/utils/scramble.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}
|
package/dist/utils/scramble.js
CHANGED
|
@@ -1,270 +1,9 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Board scrambling utilities for creating visually different but equivalent puzzles
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
* - Preventing players from recognizing puzzles they've seen before
|
|
7
|
-
* - Creating variety from a limited puzzle database
|
|
8
|
-
* - Making it harder to look up solutions online
|
|
4
|
+
* Re-exports scramble functions from @sudobility/sudojo_types for backwards compatibility.
|
|
5
|
+
* The implementation has been moved to sudojo_types to allow sharing between frontend and backend.
|
|
9
6
|
*/
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
/**
|
|
13
|
-
* Fisher-Yates shuffle algorithm for arrays
|
|
14
|
-
* @param array - Array to shuffle in place
|
|
15
|
-
* @returns The shuffled array
|
|
16
|
-
*/
|
|
17
|
-
function shuffleArray(array) {
|
|
18
|
-
for (let i = array.length - 1; i > 0; i--) {
|
|
19
|
-
const j = Math.floor(Math.random() * (i + 1));
|
|
20
|
-
const temp = array[i];
|
|
21
|
-
array[i] = array[j];
|
|
22
|
-
array[j] = temp;
|
|
23
|
-
}
|
|
24
|
-
return array;
|
|
25
|
-
}
|
|
26
|
-
/**
|
|
27
|
-
* Creates a random digit mapping (1-9 -> 1-9)
|
|
28
|
-
* @returns Map from original digit to scrambled digit
|
|
29
|
-
*/
|
|
30
|
-
function createDigitMapping() {
|
|
31
|
-
const digits = [1, 2, 3, 4, 5, 6, 7, 8, 9];
|
|
32
|
-
const shuffled = shuffleArray([...digits]);
|
|
33
|
-
const mapping = new Map();
|
|
34
|
-
for (let i = 0; i < digits.length; i++) {
|
|
35
|
-
mapping.set(digits[i], shuffled[i]);
|
|
36
|
-
}
|
|
37
|
-
return mapping;
|
|
38
|
-
}
|
|
39
|
-
/**
|
|
40
|
-
* Creates the reverse of a digit mapping
|
|
41
|
-
* @param mapping - Original digit mapping
|
|
42
|
-
* @returns Reverse mapping (scrambled -> original)
|
|
43
|
-
*/
|
|
44
|
-
function reverseDigitMapping(mapping) {
|
|
45
|
-
const reverse = new Map();
|
|
46
|
-
for (const [original, scrambled] of mapping) {
|
|
47
|
-
reverse.set(scrambled, original);
|
|
48
|
-
}
|
|
49
|
-
return reverse;
|
|
50
|
-
}
|
|
51
|
-
/**
|
|
52
|
-
* Applies digit mapping to a board
|
|
53
|
-
* @param board - 9x9 number array
|
|
54
|
-
* @param mapping - Digit mapping
|
|
55
|
-
* @returns New board with mapped digits
|
|
56
|
-
*/
|
|
57
|
-
function applyDigitMapping(board, mapping) {
|
|
58
|
-
return board.map(row => row.map(value => {
|
|
59
|
-
if (value === 0)
|
|
60
|
-
return 0;
|
|
61
|
-
return mapping.get(value) ?? value;
|
|
62
|
-
}));
|
|
63
|
-
}
|
|
64
|
-
/**
|
|
65
|
-
* Rotates the board 90 degrees clockwise
|
|
66
|
-
* @param board - Board to rotate
|
|
67
|
-
* @returns New rotated board
|
|
68
|
-
*/
|
|
69
|
-
function rotateBoard90(board) {
|
|
70
|
-
const rotated = [];
|
|
71
|
-
for (let col = 0; col < BOARD_SIZE; col++) {
|
|
72
|
-
const newRow = [];
|
|
73
|
-
for (let row = BOARD_SIZE - 1; row >= 0; row--) {
|
|
74
|
-
newRow.push(board[row]?.[col] ?? 0);
|
|
75
|
-
}
|
|
76
|
-
rotated.push(newRow);
|
|
77
|
-
}
|
|
78
|
-
return rotated;
|
|
79
|
-
}
|
|
80
|
-
/**
|
|
81
|
-
* Mirrors the board horizontally (left-right)
|
|
82
|
-
* @param board - Board to mirror
|
|
83
|
-
* @returns New mirrored board
|
|
84
|
-
*/
|
|
85
|
-
function mirrorHorizontally(board) {
|
|
86
|
-
return board.map(row => [...row].reverse());
|
|
87
|
-
}
|
|
88
|
-
/**
|
|
89
|
-
* Mirrors the board vertically (top-bottom)
|
|
90
|
-
* @param board - Board to mirror
|
|
91
|
-
* @returns New mirrored board
|
|
92
|
-
*/
|
|
93
|
-
function mirrorVertically(board) {
|
|
94
|
-
return [...board].reverse().map(row => [...row]);
|
|
95
|
-
}
|
|
96
|
-
/**
|
|
97
|
-
* Scrambles a Sudoku board while preserving its logical structure
|
|
98
|
-
*
|
|
99
|
-
* @param puzzle - 81-character puzzle string
|
|
100
|
-
* @param solution - 81-character solution string
|
|
101
|
-
* @param config - Scramble configuration (defaults to all transformations enabled)
|
|
102
|
-
* @returns Scramble result with scrambled puzzle, solution, and digit mapping
|
|
103
|
-
*
|
|
104
|
-
* @example
|
|
105
|
-
* ```typescript
|
|
106
|
-
* const result = scrambleBoard(puzzle, solution);
|
|
107
|
-
* console.log(result.puzzle); // Scrambled puzzle
|
|
108
|
-
* console.log(result.solution); // Scrambled solution
|
|
109
|
-
* console.log(result.digitMapping); // Map from original to scrambled digits
|
|
110
|
-
* ```
|
|
111
|
-
*/
|
|
112
|
-
export function scrambleBoard(puzzle, solution, config = DEFAULT_SCRAMBLE_CONFIG) {
|
|
113
|
-
// Parse the boards
|
|
114
|
-
let puzzleBoard = parseBoardString(puzzle);
|
|
115
|
-
let solutionBoard = parseBoardString(solution);
|
|
116
|
-
// Create digit mapping (applied to both puzzle and solution)
|
|
117
|
-
let digitMapping = new Map();
|
|
118
|
-
for (let i = 1; i <= 9; i++) {
|
|
119
|
-
digitMapping.set(i, i); // Identity mapping by default
|
|
120
|
-
}
|
|
121
|
-
if (config.scrambleDigits) {
|
|
122
|
-
digitMapping = createDigitMapping();
|
|
123
|
-
puzzleBoard = applyDigitMapping(puzzleBoard, digitMapping);
|
|
124
|
-
solutionBoard = applyDigitMapping(solutionBoard, digitMapping);
|
|
125
|
-
}
|
|
126
|
-
// Scramble rows within blocks
|
|
127
|
-
if (config.scrambleRows) {
|
|
128
|
-
// We need to apply the same transformation to both boards
|
|
129
|
-
// Generate the permutation first, then apply to both
|
|
130
|
-
const rowPermutations = [];
|
|
131
|
-
for (let blockRow = 0; blockRow < BLOCK_SIZE; blockRow++) {
|
|
132
|
-
rowPermutations.push(shuffleArray([0, 1, 2]));
|
|
133
|
-
}
|
|
134
|
-
const applyRowPermutation = (board) => {
|
|
135
|
-
for (let blockRow = 0; blockRow < BLOCK_SIZE; blockRow++) {
|
|
136
|
-
const startRow = blockRow * BLOCK_SIZE;
|
|
137
|
-
const perm = rowPermutations[blockRow];
|
|
138
|
-
const rowsCopy = [
|
|
139
|
-
[...(board[startRow] ?? [])],
|
|
140
|
-
[...(board[startRow + 1] ?? [])],
|
|
141
|
-
[...(board[startRow + 2] ?? [])],
|
|
142
|
-
];
|
|
143
|
-
for (let i = 0; i < BLOCK_SIZE; i++) {
|
|
144
|
-
board[startRow + i] = rowsCopy[perm[i]];
|
|
145
|
-
}
|
|
146
|
-
}
|
|
147
|
-
};
|
|
148
|
-
applyRowPermutation(puzzleBoard);
|
|
149
|
-
applyRowPermutation(solutionBoard);
|
|
150
|
-
}
|
|
151
|
-
// Scramble columns within blocks
|
|
152
|
-
if (config.scrambleColumns) {
|
|
153
|
-
const colPermutations = [];
|
|
154
|
-
for (let blockCol = 0; blockCol < BLOCK_SIZE; blockCol++) {
|
|
155
|
-
colPermutations.push(shuffleArray([0, 1, 2]));
|
|
156
|
-
}
|
|
157
|
-
const applyColPermutation = (board) => {
|
|
158
|
-
for (let blockCol = 0; blockCol < BLOCK_SIZE; blockCol++) {
|
|
159
|
-
const startCol = blockCol * BLOCK_SIZE;
|
|
160
|
-
const perm = colPermutations[blockCol];
|
|
161
|
-
for (let row = 0; row < BOARD_SIZE; row++) {
|
|
162
|
-
const boardRow = board[row];
|
|
163
|
-
if (boardRow) {
|
|
164
|
-
const colsCopy = [
|
|
165
|
-
boardRow[startCol],
|
|
166
|
-
boardRow[startCol + 1],
|
|
167
|
-
boardRow[startCol + 2],
|
|
168
|
-
];
|
|
169
|
-
for (let i = 0; i < BLOCK_SIZE; i++) {
|
|
170
|
-
boardRow[startCol + i] = colsCopy[perm[i]];
|
|
171
|
-
}
|
|
172
|
-
}
|
|
173
|
-
}
|
|
174
|
-
}
|
|
175
|
-
};
|
|
176
|
-
applyColPermutation(puzzleBoard);
|
|
177
|
-
applyColPermutation(solutionBoard);
|
|
178
|
-
}
|
|
179
|
-
// Scramble row blocks
|
|
180
|
-
if (config.scrambleRowBlocks) {
|
|
181
|
-
const blockOrder = shuffleArray([0, 1, 2]);
|
|
182
|
-
const applyRowBlockPermutation = (board) => {
|
|
183
|
-
const allRows = board.map(row => [...row]);
|
|
184
|
-
const result = [];
|
|
185
|
-
for (let newBlockIndex = 0; newBlockIndex < BLOCK_SIZE; newBlockIndex++) {
|
|
186
|
-
const oldBlockIndex = blockOrder[newBlockIndex];
|
|
187
|
-
for (let i = 0; i < BLOCK_SIZE; i++) {
|
|
188
|
-
result.push(allRows[oldBlockIndex * BLOCK_SIZE + i]);
|
|
189
|
-
}
|
|
190
|
-
}
|
|
191
|
-
return result;
|
|
192
|
-
};
|
|
193
|
-
puzzleBoard = applyRowBlockPermutation(puzzleBoard);
|
|
194
|
-
solutionBoard = applyRowBlockPermutation(solutionBoard);
|
|
195
|
-
}
|
|
196
|
-
// Scramble column blocks
|
|
197
|
-
if (config.scrambleColumnBlocks) {
|
|
198
|
-
const blockOrder = shuffleArray([0, 1, 2]);
|
|
199
|
-
const applyColBlockPermutation = (board) => {
|
|
200
|
-
const result = board.map(() => new Array(BOARD_SIZE).fill(0));
|
|
201
|
-
for (let newBlockIndex = 0; newBlockIndex < BLOCK_SIZE; newBlockIndex++) {
|
|
202
|
-
const oldBlockIndex = blockOrder[newBlockIndex];
|
|
203
|
-
for (let i = 0; i < BLOCK_SIZE; i++) {
|
|
204
|
-
const oldCol = oldBlockIndex * BLOCK_SIZE + i;
|
|
205
|
-
const newCol = newBlockIndex * BLOCK_SIZE + i;
|
|
206
|
-
for (let row = 0; row < BOARD_SIZE; row++) {
|
|
207
|
-
const resultRow = result[row];
|
|
208
|
-
if (resultRow) {
|
|
209
|
-
resultRow[newCol] = board[row]?.[oldCol] ?? 0;
|
|
210
|
-
}
|
|
211
|
-
}
|
|
212
|
-
}
|
|
213
|
-
}
|
|
214
|
-
return result;
|
|
215
|
-
};
|
|
216
|
-
puzzleBoard = applyColBlockPermutation(puzzleBoard);
|
|
217
|
-
solutionBoard = applyColBlockPermutation(solutionBoard);
|
|
218
|
-
}
|
|
219
|
-
// Rotate
|
|
220
|
-
if (config.rotate) {
|
|
221
|
-
const rotations = Math.floor(Math.random() * 4);
|
|
222
|
-
for (let i = 0; i < rotations; i++) {
|
|
223
|
-
puzzleBoard = rotateBoard90(puzzleBoard);
|
|
224
|
-
solutionBoard = rotateBoard90(solutionBoard);
|
|
225
|
-
}
|
|
226
|
-
}
|
|
227
|
-
// Mirror
|
|
228
|
-
if (config.mirror) {
|
|
229
|
-
const mirrorType = Math.floor(Math.random() * 4);
|
|
230
|
-
const applyMirror = (board) => {
|
|
231
|
-
switch (mirrorType) {
|
|
232
|
-
case 1:
|
|
233
|
-
return mirrorHorizontally(board);
|
|
234
|
-
case 2:
|
|
235
|
-
return mirrorVertically(board);
|
|
236
|
-
case 3:
|
|
237
|
-
return mirrorVertically(mirrorHorizontally(board));
|
|
238
|
-
default:
|
|
239
|
-
return board;
|
|
240
|
-
}
|
|
241
|
-
};
|
|
242
|
-
puzzleBoard = applyMirror(puzzleBoard);
|
|
243
|
-
solutionBoard = applyMirror(solutionBoard);
|
|
244
|
-
}
|
|
245
|
-
return {
|
|
246
|
-
puzzle: stringifyBoard(puzzleBoard),
|
|
247
|
-
solution: stringifyBoard(solutionBoard),
|
|
248
|
-
digitMapping,
|
|
249
|
-
reverseDigitMapping: reverseDigitMapping(digitMapping),
|
|
250
|
-
};
|
|
251
|
-
}
|
|
252
|
-
/**
|
|
253
|
-
* Creates an identity scramble result (no scrambling)
|
|
254
|
-
* @param puzzle - 81-character puzzle string
|
|
255
|
-
* @param solution - 81-character solution string
|
|
256
|
-
* @returns ScrambleResult with identity mapping
|
|
257
|
-
*/
|
|
258
|
-
export function noScramble(puzzle, solution) {
|
|
259
|
-
const identityMapping = new Map();
|
|
260
|
-
for (let i = 1; i <= 9; i++) {
|
|
261
|
-
identityMapping.set(i, i);
|
|
262
|
-
}
|
|
263
|
-
return {
|
|
264
|
-
puzzle,
|
|
265
|
-
solution,
|
|
266
|
-
digitMapping: identityMapping,
|
|
267
|
-
reverseDigitMapping: identityMapping,
|
|
268
|
-
};
|
|
269
|
-
}
|
|
7
|
+
// Re-export scramble functions from sudojo_types
|
|
8
|
+
export { scrambleBoard, noScramble } from '@sudobility/sudojo_types';
|
|
270
9
|
//# sourceMappingURL=scramble.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"scramble.js","sourceRoot":"","sources":["../../src/utils/scramble.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"scramble.js","sourceRoot":"","sources":["../../src/utils/scramble.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iDAAiD;AACjD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC"}
|
package/dist/utils/technique.js
CHANGED
|
@@ -29,7 +29,7 @@ export const TECHNIQUE_TO_HELP_FILE = {
|
|
|
29
29
|
'Locked Candidates': 'Locked_Candidates.html',
|
|
30
30
|
'Naked Triple': 'Naked_Triple.html',
|
|
31
31
|
'Hidden Triple': 'Hidden_Triple.html',
|
|
32
|
-
'Naked Quad': '
|
|
32
|
+
'Naked Quad': 'Naked_Quad.html',
|
|
33
33
|
'Hidden Quad': 'Hidden_Quad.html',
|
|
34
34
|
'X-Wing': 'X-Wing.html',
|
|
35
35
|
Swordfish: 'Swordfish.html',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"technique.js","sourceRoot":"","sources":["../../src/utils/technique.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,UAAU,GAAG,KAAK;SACrB,WAAW,EAAE;SACb,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,iBAAiB;SACtC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,kBAAkB;IACzC,OAAO,cAAc,UAAU,MAAM,CAAC;AACxC,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,sBAAsB,GAA2B;IAC5D,YAAY,EAAE,iBAAiB;IAC/B,cAAc,EAAE,mBAAmB;IACnC,eAAe,EAAE,oBAAoB;IACrC,YAAY,EAAE,iBAAiB;IAC/B,aAAa,EAAE,kBAAkB;IACjC,mBAAmB,EAAE,wBAAwB;IAC7C,cAAc,EAAE,mBAAmB;IACnC,eAAe,EAAE,oBAAoB;IACrC,YAAY,EAAE,
|
|
1
|
+
{"version":3,"file":"technique.js","sourceRoot":"","sources":["../../src/utils/technique.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@sudobility/sudojo_lib",
|
|
3
|
-
"version": "0.0.
|
|
3
|
+
"version": "0.0.41",
|
|
4
4
|
"description": "Business logic library for Sudojo app",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -47,8 +47,8 @@
|
|
|
47
47
|
"license": "MIT",
|
|
48
48
|
"devDependencies": {
|
|
49
49
|
"@sudobility/di": "^1.5.25",
|
|
50
|
-
"@sudobility/sudojo_client": "^0.0.
|
|
51
|
-
"@sudobility/sudojo_types": "^1.2.
|
|
50
|
+
"@sudobility/sudojo_client": "^0.0.38",
|
|
51
|
+
"@sudobility/sudojo_types": "^1.2.7",
|
|
52
52
|
"@sudobility/types": "^1.9.48",
|
|
53
53
|
"@tanstack/react-query": "^5.90.11",
|
|
54
54
|
"@testing-library/dom": "^10.4.1",
|
|
@@ -73,8 +73,8 @@
|
|
|
73
73
|
},
|
|
74
74
|
"peerDependencies": {
|
|
75
75
|
"@sudobility/di": "^1.5.25",
|
|
76
|
-
"@sudobility/sudojo_client": "^0.0.
|
|
77
|
-
"@sudobility/sudojo_types": "^1.2.
|
|
76
|
+
"@sudobility/sudojo_client": "^0.0.38",
|
|
77
|
+
"@sudobility/sudojo_types": "^1.2.7",
|
|
78
78
|
"@sudobility/types": "^1.9.48",
|
|
79
79
|
"@tanstack/react-query": ">=5.0.0",
|
|
80
80
|
"react": ">=18.0.0",
|