objectivehtml/FlipClock — reverse-engineered prompt

Build me a polished TypeScript library called FlipClock.js for creating animated flip style displays. I want people to be able to use it for normal clocks, countdown timers, count up counters, and flipboard style text or number displays.

It should feel like a real reusable package, not just a demo. Make it themeable, type safe, and easy to plug into a website. Include a clean public API, sensible defaults, and examples that show the main use cases. Please add tests for the important behavior and set up the project so it can be built and published as an npm package.

Also create simple documentation pages or examples so a developer can quickly see how to install it and use it. Keep the styling flexible so users can customize the look without fighting the library. Look up current docs online if you need to.