Migrate build to tsdown and vary piece shapes

[TailsProwerWorks]

Summary

• replace tsup with tsdown while preserving package entry filenames and docs IIFE output
• add deterministic per-edge shape variation for generated jigsaw pieces, with Canvas and Manufacturer opt-out/configuration
• persist piece shape profiles through import/export and document the new behavior
• update compatible dependency ranges and lockfile entries

Tests

• bun run lint
• bun run all
• npm pack --dry-run
• node -e "const hb = require('./dist/index.js'); if (!hb.Puzzle || !hb.default) throw new Error('bad cjs exports');"
• node --input-type=module -e "import hb, { Puzzle } from './dist/index.mjs'; if (!Puzzle || !hb.Puzzle) throw new Error('bad esm exports');"

Notes

• tsdown emits non-fatal MIXED_EXPORTS notices because the existing public API intentionally exposes both named exports and a default namespace.
• npm pack now includes a small tsdown Rolldown runtime chunk used by the ESM build.

Fixes #9
Fixes #6

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 6c6f3c7a-ee0e-465d-850c-09b5aef66e21

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	typescript-eslint@​8.58.2 ⏵ 8.67.0			+1
	@​vitest/​coverage-v8@​4.1.4 ⏵ 4.1.11				+2
	vitest@​4.1.4 ⏵ 4.1.11	+1		+1	+1
	jiti@​2.6.1 ⏵ 2.7.0	+1		+1
	tsdown@​0.22.14
	konva@​10.2.5 ⏵ 10.3.1				+4
	@​antfu/​eslint-config@​8.2.0 ⏵ 8.3.0				+1
	jsdom@​29.0.2 ⏵ 29.1.1			+1
	eslint@​10.2.1 ⏵ 10.9.0				+1

View full report

[socket-security]

Warning

Review the following alerts detected in dependencies.

According to your organization's Security Policy, it is recommended to resolve "Warn" alerts. Learn more about Socket for GitHub.

Action	Severity	Alert  (click "▶" to expand/collapse)
Warn		Obfuscated code: npm jsdom is 90.0% likely obfuscated Confidence: 0.90 Location: Package overview From: package.json → npm/jsdom@29.1.1 ℹ Read more on: This package | This alert | What is obfuscated code? Next steps: Take a moment to review the security alert above. Review the linked package source code to understand the potential risk. Ensure the package is not malicious before proceeding. If you're unsure how to proceed, reach out to your security team or ask the Socket team for help at support@socket.dev. Suggestion: Packages should not obfuscate their code. Consider not using packages with obfuscated code. Mark the package as acceptable risk. To ignore this alert only in this pull request, reply with the comment @SocketSecurity ignore npm/jsdom@29.1.1. You can also ignore all packages with @SocketSecurity ignore-all. To ignore an alert for all future pull requests, use Socket's Dashboard to change the triage state of this alert.

View full report

[codecov]

Welcome to Codecov 🎉

Once you merge this PR into your default branch, you're all set! Codecov will compare coverage reports and display results in all future pull requests.

ℹ️ You can also turn on project coverage checks and project coverage reporting on Pull Request comment

Thanks for integrating Codecov - We've got you covered ☂️

[TailsProwerWorks]

Follow-up for review feedback:

• Replaced all generic .length assertions using toBe/equivalent patterns in the test suite with toHaveLength(...), including the additional nested outline test case.
• Added user-facing docs for generated piece shape variation at /guides/piece-shape-variation/ and linked it in the docs sidebar.
• Installed docs dependencies from the existing docs lockfile to validate the Astro docs build; docs/bun.lock was normalized to match docs/package.json ranges, with no package version upgrade added in this follow-up.

Verification run:

• bun test test/canvas.test.ts test/manufacturer.test.ts test/outline.test.ts test/puzzle.test.ts test/shuffler.test.ts - 94 passed
• bun run lint - passed
• bun run typecheck - passed
• bun run all - 19 files / 315 tests passed; build passed with existing tsdown MIXED_EXPORTS notices
• bun run build in docs/ initially failed because Astro telemetry tried to write /home/sandbox/.config/astro; rerun with ASTRO_TELEMETRY_DISABLED=1 XDG_CONFIG_HOME=/tmp/astro-config XDG_CACHE_HOME=/tmp/astro-cache bun run build passed and generated /guides/piece-shape-variation/index.html.
• npm pack --dry-run - passed
• CJS and ESM export smoke checks - passed

Commit: 58ee298

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.2% Duplication on New Code

See analysis details on SonarQube Cloud