> ## Documentation Index
> Fetch the complete documentation index at: https://docs.instructorphp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# V1.10.0

## 1.10.0 Summary

This is a release focused mostly on type safety & static analysis. We have made comprehensive improvements to PHPDoc annotations, generic types, null-safety, and PHP 8.3+ compatibility.

***

## ✨ Features & Improvements

### Type Safety Enhancements (All Packages)

* **Generic Type Support**: Added comprehensive `@template`, `@param`, and `@return` PHPDoc annotations across collections, operators, and state processors
* **PHP 8.3+ Compatibility**: Added `#[\Override]` attributes to 300+ method implementations for compile-time verification
* **Strict Type Checking**: Applied `strict_types=1` declarations and strict comparison operators throughout
* **Callable Signatures**: Enhanced PHPDoc with precise callable type hints (e.g., `callable(Section): bool`)

### Null-Safety Improvements

* **schema**: Fixed nullable type handling in `TypeDetails`, `SignatureField`, and reflection classes
* **instructor**: Better null handling in deserialization layer (`CustomObjectNormalizer`, `FlexibleDateDenormalizer`)
* **messages**: Fixed null pointer issues in `Messages::firstRole()`, `Messages::lastRole()`, and filter operations
* **auxiliary**: Added type guards in `Codebase::getMethodParams()` and `RawHtml::convertToAbsoluteUrls()`
* **dynamic**: Explicit null initialization for `Field::$value` and `Field::$validator` properties

### Collection API Standardization (utils)

* Renamed `ArrayList::get()` → `ArrayList::itemAt()` for interface consistency
* Added comprehensive generic type annotations to `ArrayList`, `ArrayMap`, `ArraySet`
* Improved `TagMap` type safety with proper tag storage annotations

### Result Monad Enhancements (utils)

Helper methods for batch operations:

```php theme={null}
Result::tryAll(callable ...$operations): Result  // Execute all, aggregate errors
Result::tryUntil(callable ...$operations): Result  // Execute until first success
```

Improved error aggregation via `CompositeException` for better debugging.

### State Processing (addons)

* Added `forceThrowOnFailure` parameter to `Chat` class for graceful error handling
* Enhanced generic type constraints in `StateProcessors`, `ContinuationCriteria`, and middleware chains
* Added `ChatFactory::defaultProcessors()` helper method

***

## 🐛 Bug Fixes

### File Operations

* **doctor**: Fixed `glob()` returning `false` instead of empty arrays (multiple files)
* **doctor**: Fixed unhandled `false` returns from `file_get_contents()`, `realpath()`, and `preg_replace()`
* **instructor**: Fixed file operation error handling with runtime exceptions

### Type Safety

* **auxiliary**: Fixed null safety in parameter extraction and DOM element handling
* **dynamic**: Fixed schema immutability violations in `Field::withName()` and `Field::withDescription()`
* **messages**: Added runtime exceptions for empty collection operations instead of returning null
* **schema**: Improved nullable type handling with proper null coalescing and type guards
* **pipeline**: Better null handling in `StepTimingTag::startDateTime()`

### Array Operations

* **evals**: Fixed array key conflicts in `MakeObservations` and `SelectObservations` using `array_values()`
* **schema**: Added strict type comparisons to all `in_array()` calls