@cubingcenter/scrambler 0.5.2 → 0.5.3

package/dist/puzzles/cube3/solver/browser-worker-pool.d.ts

@@ -1,31 +0,0 @@
-import type { ScrambleOptions, ScrambleResult } from "../../../core/types.js";
-/**
- * Web Worker pool for browser environments.
- *
- * Each worker loads solver tables independently (~10 MB per worker).
- * Best suited for batch generation on client devices with 2+ cores.
- *
- * Usage:
- * ```ts
- * const pool = new Cube3BrowserWorkerPool();
- * const results = await pool.generateBatch(50, (i) => `seed-${i}`);
- * pool.terminate();
- * ```
- */
-export declare class Cube3BrowserWorkerPool {
-    private workers;
-    private available;
-    private pending;
-    private queue;
-    private nextId;
-    private terminated;
-    constructor(size?: number);
-    generate(options?: ScrambleOptions & {
-        skipValidation?: boolean;
-    }): Promise<ScrambleResult>;
-    generateBatch(count: number, deriveSeed: (index: number) => string | number | undefined): Promise<ScrambleResult[]>;
-    terminate(): void;
-    private handleResponse;
-    private handleError;
-}
-//# sourceMappingURL=browser-worker-pool.d.ts.map

package/dist/puzzles/cube3/solver/browser-worker-pool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser-worker-pool.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube3/solver/browser-worker-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAiC9E;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAS;gBAGzB,IAAI,GAAE,MAA2D;IA2BnE,QAAQ,CACN,OAAO,GAAE,eAAe,GAAG;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAO,GAC3D,OAAO,CAAC,cAAc,CAAC;IA0B1B,aAAa,CACX,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,SAAS,GACzD,OAAO,CAAC,cAAc,EAAE,CAAC;IAQ5B,SAAS,IAAI,IAAI;IAajB,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,WAAW;CAIpB"}

package/dist/puzzles/cube3/solver/browser-worker-pool.js

@@ -1,118 +0,0 @@
-function getHardwareConcurrency() {
-    if (typeof navigator !== "undefined" && navigator.hardwareConcurrency) {
-        return navigator.hardwareConcurrency;
-    }
-    return 4;
-}
-function resolveWorkerUrl() {
-    // Standard ESM pattern: bundlers (Vite, Webpack 5, Parcel) detect
-    // new Worker(new URL('./file.js', import.meta.url)) and handle the worker
-    // as a separate chunk automatically.
-    return new URL("./browser-worker.js", import.meta.url).href;
-}
-/**
- * Web Worker pool for browser environments.
- *
- * Each worker loads solver tables independently (~10 MB per worker).
- * Best suited for batch generation on client devices with 2+ cores.
- *
- * Usage:
- * ```ts
- * const pool = new Cube3BrowserWorkerPool();
- * const results = await pool.generateBatch(50, (i) => `seed-${i}`);
- * pool.terminate();
- * ```
- */
-export class Cube3BrowserWorkerPool {
-    workers = [];
-    available = [];
-    pending = new Map();
-    queue = [];
-    nextId = 0;
-    terminated = false;
-    constructor(size = Math.max(1, Math.min(8, getHardwareConcurrency()))) {
-        if (typeof Worker === "undefined") {
-            throw new Error("Web Workers are not available in this environment. " +
-                "Use generateScramble() directly for single-threaded generation.");
-        }
-        const workerUrl = resolveWorkerUrl();
-        for (let i = 0; i < size; i++) {
-            const worker = new Worker(workerUrl, { type: "module" });
-            worker.onmessage = (event) => {
-                this.handleResponse(worker, event.data);
-            };
-            worker.onerror = (error) => {
-                this.handleError(error);
-            };
-            this.workers.push(worker);
-            this.available.push(worker);
-        }
-    }
-    generate(options = {}) {
-        if (this.terminated) {
-            return Promise.reject(new Error("Worker pool has been terminated."));
-        }
-        const id = this.nextId++;
-        const task = {
-            id,
-            ...(options.seed !== undefined ? { seed: options.seed } : {}),
-            ...(options.skipValidation !== undefined
-                ? { skipValidation: options.skipValidation }
-                : {})
-        };
-        return new Promise((resolve, reject) => {
-            this.pending.set(id, { resolve, reject });
-            if (this.available.length > 0) {
-                const worker = this.available.pop();
-                worker.postMessage(task);
-            }
-            else {
-                this.queue.push(task);
-            }
-        });
-    }
-    generateBatch(count, deriveSeed) {
-        const promises = Array.from({ length: count }, (_, index) => {
-            const seed = deriveSeed(index);
-            return this.generate(seed !== undefined ? { seed } : {});
-        });
-        return Promise.all(promises);
-    }
-    terminate() {
-        this.terminated = true;
-        this.queue = [];
-        this.pending.forEach(({ reject }) => {
-            reject(new Error("Worker pool terminated."));
-        });
-        this.pending.clear();
-        for (const worker of this.workers) {
-            worker.terminate();
-        }
-    }
-    handleResponse(worker, response) {
-        const pending = this.pending.get(response.id);
-        if (!pending)
-            return;
-        this.pending.delete(response.id);
-        if (response.error) {
-            pending.reject(new Error(response.error));
-        }
-        else if (response.result) {
-            pending.resolve(response.result);
-        }
-        else {
-            pending.reject(new Error("Worker returned empty response."));
-        }
-        if (this.queue.length > 0) {
-            const nextTask = this.queue.shift();
-            worker.postMessage(nextTask);
-        }
-        else {
-            this.available.push(worker);
-        }
-    }
-    handleError(error) {
-        this.pending.forEach(({ reject }) => reject(error.error));
-        this.pending.clear();
-    }
-}

package/dist/puzzles/cube3/solver/browser-worker.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=browser-worker.d.ts.map

package/dist/puzzles/cube3/solver/browser-worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser-worker.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube3/solver/browser-worker.ts"],"names":[],"mappings":""}

package/dist/puzzles/cube3/solver/browser-worker.js

@@ -1,71 +0,0 @@
-/// <reference lib="webworker" />
-import { generateRandomCube3State } from "../random-state.js";
-import { createSolvedCube3State, cube3StatesEqual, isSolvedCube3State } from "../state.js";
-import { applyCube3Algorithm, formatCube3Algorithm, invertCube3Algorithm } from "../moves.js";
-import { formatCube3Facelets, toCube3Facelets } from "../facelets.js";
-import { solveCube3State } from "./index.js";
-import { loadBrowserTables } from "./browser-loader.js";
-let tablesLoaded = false;
-async function ensureTables() {
-    if (tablesLoaded)
-        return;
-    await loadBrowserTables();
-    tablesLoaded = true;
-}
-async function generate(task) {
-    await ensureTables();
-    const options = {
-        ...(task.seed !== undefined ? { seed: task.seed } : {}),
-        ...(task.skipValidation !== undefined ? { skipValidation: task.skipValidation } : {})
-    };
-    const state = generateRandomCube3State(options);
-    const solution = await solveCube3State(state);
-    const scrambleMoves = invertCube3Algorithm(solution.moves);
-    if (!options.skipValidation) {
-        const scrambledState = applyCube3Algorithm(createSolvedCube3State(), scrambleMoves);
-        if (!cube3StatesEqual(scrambledState, state)) {
-            throw new Error("Generated 3x3 scramble does not reproduce the target random state.");
-        }
-        if (!isSolvedCube3State(solution.state)) {
-            throw new Error("Generated 3x3 solution does not solve the target random state.");
-        }
-        if (scrambleMoves.length < 2) {
-            throw new Error("Generated 3x3 scramble is too short.");
-        }
-    }
-    const facelets = toCube3Facelets(state);
-    const result = {
-        eventId: "333",
-        scramble: formatCube3Algorithm(scrambleMoves),
-        moves: scrambleMoves,
-        quality: "random-state",
-        generator: "cube3-two-phase",
-        metadata: {
-            state,
-            facelets,
-            faceletString: formatCube3Facelets(facelets),
-            solutionMoves: solution.moves,
-            solutionDepth: solution.depth,
-            phase1Depth: solution.phase1.depth,
-            phase2Depth: solution.phase2.depth,
-            visitedNodes: solution.visitedNodes
-        }
-    };
-    if (options.seed !== undefined) {
-        result.seed = options.seed;
-    }
-    return result;
-}
-self.onmessage = async (event) => {
-    const task = event.data;
-    try {
-        const result = await generate(task);
-        const response = { id: task.id, result };
-        self.postMessage(response);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        const response = { id: task.id, error: message };
-        self.postMessage(response);
-    }
-};

package/dist/puzzles/cube3/solver/worker-pool.d.ts

@@ -1,18 +0,0 @@
-import type { ScrambleOptions, ScrambleResult } from "../../../core/types.js";
-export declare class Cube3WorkerPool {
-    private workers;
-    private available;
-    private pending;
-    private queue;
-    private nextId;
-    private terminated;
-    constructor(size?: number);
-    generate(options?: ScrambleOptions & {
-        skipValidation?: boolean;
-    }): Promise<ScrambleResult>;
-    generateBatch(count: number, deriveSeed: (index: number) => string | number | undefined): Promise<ScrambleResult[]>;
-    terminate(): Promise<number[]>;
-    private handleResponse;
-    private handleError;
-}
-//# sourceMappingURL=worker-pool.d.ts.map

package/dist/puzzles/cube3/solver/worker-pool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube3/solver/worker-pool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAkC9E,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,UAAU,CAAS;gBAEf,IAAI,GAAE,MAAgD;IAsBlE,QAAQ,CAAC,OAAO,GAAE,eAAe,GAAG;QAAE,cAAc,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,cAAc,CAAC;IAwB/F,aAAa,CACX,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,SAAS,GACzD,OAAO,CAAC,cAAc,EAAE,CAAC;IAQ5B,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAW9B,OAAO,CAAC,cAAc;IAqBtB,OAAO,CAAC,WAAW;CAMpB"}

package/dist/puzzles/cube3/solver/worker-pool.js

@@ -1,116 +0,0 @@
-import { Worker } from "node:worker_threads";
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-import os from "node:os";
-function resolveWorkerPath() {
-    const currentFile = fileURLToPath(import.meta.url);
-    const currentDir = dirname(currentFile);
-    const isSource = currentFile.includes("/src/") || currentFile.includes("\\src\\");
-    const filename = isSource ? "worker.ts" : "worker.js";
-    return join(currentDir, filename);
-}
-function getWorkerExecArgv() {
-    const currentFile = fileURLToPath(import.meta.url);
-    const isSource = currentFile.includes("/src/") || currentFile.includes("\\src\\");
-    if (!isSource)
-        return [];
-    return ["--import", "tsx"];
-}
-export class Cube3WorkerPool {
-    workers = [];
-    available = [];
-    pending = new Map();
-    queue = [];
-    nextId = 0;
-    terminated = false;
-    constructor(size = Math.max(1, Math.min(8, getCpuCount()))) {
-        const workerPath = resolveWorkerPath();
-        const execArgv = getWorkerExecArgv();
-        for (let i = 0; i < size; i++) {
-            const worker = new Worker(workerPath, {
-                execArgv
-            });
-            worker.on("message", (response) => {
-                this.handleResponse(worker, response);
-            });
-            worker.on("error", (error) => {
-                this.handleError(error);
-            });
-            this.workers.push(worker);
-            this.available.push(worker);
-        }
-    }
-    generate(options = {}) {
-        if (this.terminated) {
-            return Promise.reject(new Error("Worker pool has been terminated."));
-        }
-        const id = this.nextId++;
-        const task = {
-            id,
-            ...(options.seed !== undefined ? { seed: options.seed } : {}),
-            ...(options.skipValidation !== undefined ? { skipValidation: options.skipValidation } : {})
-        };
-        return new Promise((resolve, reject) => {
-            this.pending.set(id, { resolve, reject });
-            if (this.available.length > 0) {
-                const worker = this.available.pop();
-                worker.postMessage(task);
-            }
-            else {
-                this.queue.push(task);
-            }
-        });
-    }
-    generateBatch(count, deriveSeed) {
-        const promises = Array.from({ length: count }, (_, index) => {
-            const seed = deriveSeed(index);
-            return this.generate(seed !== undefined ? { seed } : {});
-        });
-        return Promise.all(promises);
-    }
-    terminate() {
-        this.terminated = true;
-        this.queue = [];
-        this.pending.forEach(({ reject }) => {
-            reject(new Error("Worker pool terminated."));
-        });
-        this.pending.clear();
-        return Promise.all(this.workers.map((w) => w.terminate()));
-    }
-    handleResponse(worker, response) {
-        const pending = this.pending.get(response.id);
-        if (!pending)
-            return;
-        this.pending.delete(response.id);
-        if (response.error) {
-            pending.reject(new Error(response.error));
-        }
-        else if (response.result) {
-            pending.resolve(response.result);
-        }
-        else {
-            pending.reject(new Error("Worker returned empty response."));
-        }
-        if (this.queue.length > 0) {
-            const nextTask = this.queue.shift();
-            worker.postMessage(nextTask);
-        }
-        else {
-            this.available.push(worker);
-        }
-    }
-    handleError(error) {
-        // If a worker crashes, reject all pending tasks
-        // In a production system we'd respawn the worker
-        this.pending.forEach(({ reject }) => reject(error));
-        this.pending.clear();
-    }
-}
-function getCpuCount() {
-    try {
-        return os.cpus().length;
-    }
-    catch {
-        return 4;
-    }
-}

package/dist/puzzles/cube3/solver/worker.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=worker.d.ts.map

package/dist/puzzles/cube3/solver/worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../../src/puzzles/cube3/solver/worker.ts"],"names":[],"mappings":""}

package/dist/puzzles/cube3/solver/worker.js

@@ -1,73 +0,0 @@
-import { parentPort } from "node:worker_threads";
-import { generateRandomCube3State } from "../random-state.js";
-import { createSolvedCube3State, cube3StatesEqual, isSolvedCube3State } from "../state.js";
-import { applyCube3Algorithm, formatCube3Algorithm, invertCube3Algorithm } from "../moves.js";
-import { formatCube3Facelets, toCube3Facelets } from "../facelets.js";
-import { solveCube3State } from "./index.js";
-let tablesLoaded = false;
-async function ensureTables() {
-    if (tablesLoaded)
-        return;
-    const { loadCube3SolverTables } = await import("./tables.js");
-    await loadCube3SolverTables();
-    tablesLoaded = true;
-}
-async function generate(task) {
-    await ensureTables();
-    const options = {
-        ...(task.seed !== undefined ? { seed: task.seed } : {}),
-        ...(task.skipValidation !== undefined ? { skipValidation: task.skipValidation } : {})
-    };
-    const state = generateRandomCube3State(options);
-    const solution = await solveCube3State(state);
-    const scrambleMoves = invertCube3Algorithm(solution.moves);
-    if (!options.skipValidation) {
-        const scrambledState = applyCube3Algorithm(createSolvedCube3State(), scrambleMoves);
-        if (!cube3StatesEqual(scrambledState, state)) {
-            throw new Error("Generated 3x3 scramble does not reproduce the target random state.");
-        }
-        if (!isSolvedCube3State(solution.state)) {
-            throw new Error("Generated 3x3 solution does not solve the target random state.");
-        }
-        if (scrambleMoves.length < 2) {
-            throw new Error("Generated 3x3 scramble is too short.");
-        }
-    }
-    const facelets = toCube3Facelets(state);
-    const result = {
-        eventId: "333",
-        scramble: formatCube3Algorithm(scrambleMoves),
-        moves: scrambleMoves,
-        quality: "random-state",
-        generator: "cube3-two-phase",
-        metadata: {
-            state,
-            facelets,
-            faceletString: formatCube3Facelets(facelets),
-            solutionMoves: solution.moves,
-            solutionDepth: solution.depth,
-            phase1Depth: solution.phase1.depth,
-            phase2Depth: solution.phase2.depth,
-            visitedNodes: solution.visitedNodes
-        }
-    };
-    if (options.seed !== undefined) {
-        result.seed = options.seed;
-    }
-    return result;
-}
-if (!parentPort) {
-    throw new Error("This module must be run as a worker thread.");
-}
-parentPort.on("message", async (task) => {
-    try {
-        const result = await generate(task);
-        const response = { id: task.id, result };
-        parentPort.postMessage(response);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        const response = { id: task.id, error: message };
-        parentPort.postMessage(response);
-    }
-});