Upgrading
Upgrading from 1.x and other card libraries
Move from 1.x to 2.x, stay on 2.x, and come from another card library.
From 1.x to 2.x
Version 2 changed multiword entry-point paths to kebab case: /oh-hell, /crazy-eights, /go-fish, /big-two and /gin-rummy. The previous camelCase import paths changed; saved-game keys such as crazyEights remained unchanged. Update imports and demo URL game values, rather than rewriting saved logs. The 2.0.0 changelog records the migration.
Within 2.x
Keep the named imports you use, the existing element definition entries and native game codecs. The typed defineHand helper’s standard tag is toranpu-hand; its checked example uses that published type.
Coming from another card library
Distinguish card objects, short game ids and packed solitaire numbers. Transfer a deck through native readers/converters, not by assigning one representation to another. Native game setup, legal moves, house rules and scoring belong to that engine. Registering artwork changes presentation rather than those rules.