vicc/chameleon ? reverse-engineered prompt

Build me a lightweight iOS color utility library that helps apps look polished without a lot of manual color work.

I want it to support both Swift and Objective C, and make it easy to use built in flat colors, generate matching color schemes from a color, get contrasting text colors automatically, and create gradients for things like backgrounds, text, and tint. It should also be able to pull colors from images, including an average color and useful schemes from a photo. If possible, include a simple way to theme views with very little code, plus support for a storyboard friendly color palette and clear inline documentation so methods are easy to discover in Xcode.

Please set it up as a reusable framework with a small demo app showing the main features in action. Keep it clean, lightweight, and easy to drop into an existing iOS project. If you need to check current docs or best practices for old iOS compatibility, look them up online first.