Architecture and data

The Next.js app serves the workspace and help pages. React uses product-sdk 0.10.3 components. The app stores no survey data on the server.

src/csv.ts parses input. src/data.ts provides examples and CSV output. src/workspace.tsx owns session state. src/worker.ts calls the public turfLP API in browser workers. A run uses up to four workers, one fewer than the processor cores, and never more than the number of sizes. Each worker solves one size, and takes the next size as soon as it finishes. Each request has an ID. The page ignores replies from old workers. Cancel terminates the run workers. A separate worker runs the deep dive, and another finds the full cover, so neither waits behind a run.

The app pins turfLP 0.5.0 from npm and an official product-sdk archive under vendor/. Build code copies WASM and SDK browser assets into public/. No private registry token is needed for a build. Public solver code has no dependency on this app or product-sdk.

The help site uses the SDK DocumentationShell. Its source is docs/app/index.json and docs/app/pages/. The app maintainer owns documentation updates. These pages contain public user instructions. Private repository metadata and design review records are not served as help pages.