Feat/type cast models

[gwillz]

This combines a few PRs from Sprout.

We somewhat had a split implementation between settings defaults and typecasting within Sprout. I also wanted the tests located closer to the implementation.

I've modified the original json/sets PR into a more generic typecasting helper. This also accommodates date field types and anything else someone might want to patch in.

Sprout also runs with NO_ENGINE_SUBSTITUTE at all times. Which isn't ideal because it's a weaker model than the default SQL mode. In that I also found that booleans were also not casted correctly when committed.

The piece that makes this all a bit more possible is the introduction of the populate() method. PdbModelTrait doesn't (and can't) enforce the Configurable interface, and vaguely aligning the types didn't feel right either. More importantly this solves other problems that I came up against recently where I wanted to distinguish between data from the DB and data from a controller. Something that a single update() couldn't easily solve.

[Copilot]

Pull request overview

This PR consolidates model typecasting/default-handling by introducing a populate() pathway for building models from DB rows, adding round-trip support for native typed properties (incl. SET/JSON/datetime), and relocating/expanding tests around that behavior.

Changes:

• Add PdbModelInterface::populate() and update result hydration (PdbReturn) to use it for Pdb models.
• Implement type casting on hydrate and type-aware serialization on save (arrays→SET/JSON, bool→int, DateTime→string).
• Add a dedicated test table/model and PHPUnit coverage for typed save/load and defaults.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
tests/db_struct.xml	Adds a new dummy table with JSON/SET and defaulted columns to exercise typed behavior.
tests/PdbModelTest.php	Adds save/load/default override tests using the new typed dummy model.
tests/Models/TypedModel.php	Introduces a typed test model and custom save data composition.
src/PdbModelTrait.php	Adds populate(), typecasting on hydrate, and serialization rules in getSaveData().
src/PdbModelInterface.php	Adds the new populate() method to the public model interface.
src/Pdb.php	Ensures boolean parameters bind as integers in prepared statements.
src/Models/PdbReturn.php	Switches hydration to populate() when hydrating PdbModelInterface classes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.