Fix remaining method signature issues across documentation (#8185)

* Add missing type annotations to core library method signatures

Updated method signatures to include proper type annotations:
- app.md: className() parameter types
- collections.md: ~33 methods with full type annotations
- email.md: setAttachments(), setEmailPattern() types and return
- inflector.md: All 10 methods already had types (verified)
- number.md: setDefaultCurrency() static and nullable type
- text.md: transliterate(), toList() types (verified)
- time.md: setJsonEncodeFormat(), i18nFormat(), comparison methods
- xml.md: build(), toArray() types (verified)

Refs #7744

* Fix remaining method signature issues across documentation

- Fix malformed markdown syntax in table-objects.md (buildRules) and
  counter-cache.md (updateCounterCache) causing rendering issues
- Add missing type annotations to ORM methods (save, findOrCreate,
  updateAll, deleteAll, Entity methods, ConnectionManager, TypeFactory)
- Add parameter types to Controller methods (set, addViewClasses,
  fetchTable, fetchModel)
- Add types to Response and CorsBuilder methods in request-response.md
- Add types to ConsoleOptionParser methods in option-parsers.md
- Add types to Helper callback methods and PaginatorHelper methods

Author: dereuromark

docs/en/console-commands/option-parsers.md

@@ -38,7 +38,7 @@ public function getOptionParser()
 
 ## Using Arguments
 
-`method` Cake\\Console\\ConsoleOptionParser::**addArgument**($name, $params = [])
+`method` Cake\\Console\\ConsoleOptionParser::**addArgument**(string $name, array $params = []): static
 
 Positional arguments are frequently used in command line tools,
 and `ConsoleOptionParser` allows you to define positional
@@ -73,7 +73,7 @@ The `separator` option was added.
 
 ### Adding Multiple Arguments
 
-`method` Cake\\Console\\ConsoleOptionParser::**addArguments**(array $args)
+`method` Cake\\Console\\ConsoleOptionParser::**addArguments**(array $args): static
 
 If you have an array with multiple arguments you can use
 `$parser->addArguments()` to add multiple arguments at once. :
@@ -109,7 +109,7 @@ will be raised and the shell will be stopped.
 
 ## Using Options
 
-`method` Cake\\Console\\ConsoleOptionParser::**addOption**($name, array $options = [])
+`method` Cake\\Console\\ConsoleOptionParser::**addOption**(string $name, array $options = []): static
 
 Options or flags are used in command line tools to provide unordered key/value
 arguments for your commands. Options can define both verbose and short aliases.
@@ -164,7 +164,7 @@ The `separator` option was added.
 
 ### Adding Multiple Options
 
-`method` Cake\\Console\\ConsoleOptionParser::**addOptions**(array $options)
+`method` Cake\\Console\\ConsoleOptionParser::**addOptions**(array $options): static
 
 If you have an array with multiple options you can use `$parser->addOptions()`
 to add multiple options at once. :
@@ -241,7 +241,7 @@ public function getOptionParser()
 
 ### Merging Option Parsers
 
-`method` Cake\\Console\\ConsoleOptionParser::**merge**($spec)
+`method` Cake\\Console\\ConsoleOptionParser::**merge**(ConsoleOptionParser $spec): static
 
 When building a group command, you maybe want to combine several parsers for
 this:
@@ -348,7 +348,7 @@ epilog.
 
 ### Set the Description
 
-`method` Cake\\Console\\ConsoleOptionParser::**setDescription**($text)
+`method` Cake\\Console\\ConsoleOptionParser::**setDescription**(array|string $text): static
 
 The description displays above the argument and option information. By passing
 in either an array or a string, you can set the value of the description:
@@ -363,7 +363,7 @@ $parser->getDescription();
 
 ### Set the Epilog
 
-`method` Cake\\Console\\ConsoleOptionParser::**setEpilog**($text)
+`method` Cake\\Console\\ConsoleOptionParser::**setEpilog**(array|string $text): static
 
 Gets or sets the epilog for the option parser. The epilog is displayed after the
 argument and option information. By passing in either an array or a string, you

docs/en/controllers.md

@@ -147,7 +147,7 @@ rendered from the controller.
 
 ### Setting View Variables
 
-`method` Cake\\Controller\\Controller::**set**(string $var, mixed $value)
+`method` Cake\\Controller\\Controller::**set**(string $var, mixed $value): void
 
 The `Controller::set()` method is the main way to send data from your
 controller to your view. Once you've used `Controller::set()`, the variable
@@ -290,7 +290,7 @@ This would render **plugins/Users/templates/UserDetails/custom_file.php**
 
 ## Content Type Negotiation
 
-`method` Cake\\Controller\\Controller::**addViewClasses**(array $viewClasses)
+`method` Cake\\Controller\\Controller::**addViewClasses**(array $viewClasses): static
 
 Controllers can define a list of view classes they support. After the
 controller's action is complete CakePHP will use the view list to perform
@@ -462,7 +462,7 @@ a life-cycle handler.
 
 ## Loading Additional Tables/Models
 
-`method` Cake\\Controller\\Controller::**fetchTable**(string $alias, array $config = [])
+`method` Cake\\Controller\\Controller::**fetchTable**(?string $alias = null, array $options = []): Table
 
 The `fetchTable()` method comes handy when you need to use an ORM table that is not
 the controller's default one:
@@ -478,7 +478,7 @@ $recentArticles = $this->fetchTable('Articles')->find('all',
 
 ### fetchModel()
 
-`method` Cake\\Controller\\Controller::**fetchModel**(string|null $modelClass = null, string|null $modelType = null)
+`method` Cake\\Controller\\Controller::**fetchModel**(?string $modelClass = null, ?string $modelType = null): object
 
 The `fetchModel()` method is useful to load non ORM models or ORM tables that
 are not the controller's default:

docs/en/controllers/request-response.md

@@ -823,7 +823,7 @@ public function sendIcs()
 
 ### Setting Headers
 
-`method` Cake\\Http\\Response::**withHeader**($header, $value)
+`method` Cake\\Http\\Response::**withHeader**(string $header, string $value): static
 
 Setting headers is done with the `Cake\Http\Response::withHeader()`
 method. Like all of the PSR-7 interface methods, this method returns a *new*
@@ -863,7 +863,7 @@ $response = $response->withType('application/json')
     ->withStringBody(json_encode(['Foo' => 'bar']));
 ```
 
-`method` Cake\\Http\\Response::**withBody**($body)
+`method` Cake\\Http\\Response::**withBody**(StreamInterface $body): static
 
 To set the response body, use the `withBody()` method, which is provided by the
 `Laminas\Diactoros\MessageTrait`:
@@ -1193,17 +1193,17 @@ criteria are met:
 
 The `CorsBuilder` provides the following methods for configuring CORS:
 
-`method` Cake\\Http\\CorsBuilder::**allowOrigin**(array|string $domains)
+`method` Cake\\Http\\CorsBuilder::**allowOrigin**(array|string $domains): static
 
-`method` Cake\\Http\\CorsBuilder::**allowMethods**(array $methods)
+`method` Cake\\Http\\CorsBuilder::**allowMethods**(array $methods): static
 
-`method` Cake\\Http\\CorsBuilder::**allowHeaders**(array $headers)
+`method` Cake\\Http\\CorsBuilder::**allowHeaders**(array $headers): static
 
-`method` Cake\\Http\\CorsBuilder::**allowCredentials**()
+`method` Cake\\Http\\CorsBuilder::**allowCredentials**(): static
 
-`method` Cake\\Http\\CorsBuilder::**exposeHeaders**(array $headers)
+`method` Cake\\Http\\CorsBuilder::**exposeHeaders**(array $headers): static
 
-`method` Cake\\Http\\CorsBuilder::**maxAge**(string|int $age)
+`method` Cake\\Http\\CorsBuilder::**maxAge**(string|int $age): static
 
 `method` Cake\\Http\\CorsBuilder::**build**(): ResponseInterface
 

docs/en/orm/behaviors/counter-cache.md

@@ -168,7 +168,7 @@ Finally clear all caches with `bin/cake cache clear_all` and try it out.
 
 ## Manually updating counter caches
 
-`method` Cake\\ORM\\Behavior\\CounterCacheBehavior::**updateCounterCache(?string $assocName = null, int $limit = 100, ?int $page = null): void**()
+`method` Cake\\ORM\\Behavior\\CounterCacheBehavior::**updateCounterCache**(?string $assocName = null, int $limit = 100, ?int $page = null): void
 
 The `updateCounterCache()` method allows you to update the counter cache values
 for all records of one or all configured associations in batches. This can be useful,

docs/en/orm/database-basics.md

@@ -339,7 +339,7 @@ references to existing connections.
 
 ### Accessing Connections
 
-`static` Cake\\Datasource\\ConnectionManager::**get**($name): ConnectionInterface
+`static` Cake\\Datasource\\ConnectionManager::**get**(string $name): ConnectionInterface
 
 Once configured connections can be fetched using
 `Cake\Datasource\ConnectionManager::get()`. This method will
@@ -518,7 +518,7 @@ Maps to a native `DATETIME` column type. In PostgreSQL and SQL Server this
 turns into a `TIMESTAMP` type. The default return value of this column type is
 `Cake\I18n\DateTime` which extends [Chronos](https://github.com/cakephp/chronos) and the native `DateTimeImmutable`.
 
-`method` Cake\\Database\\DateTimeType::**setTimezone**(string|\\DateTimeZone|null $timezone)
+`method` Cake\\Database\\DateTimeType::**setTimezone**(string|DateTimeZone|null $timezone): static
 
 If your database server's timezone does not match your application's PHP timezone
 then you can use this method to specify your database's timezone. This timezone
@@ -646,7 +646,7 @@ Geospatial schema types were added.
 
 `class` Cake\\Database\\**TypeFactory**
 
-`static` Cake\\Database\\TypeFactory::**map**($name, $class): void
+`static` Cake\\Database\\TypeFactory::**map**(string $name, string $class): void
 
 If you need to use vendor specific types that are not built into CakePHP you can
 add additional new types to CakePHP's type system. Type classes are expected to

docs/en/orm/deleting-data.md

@@ -84,7 +84,7 @@ records with these method **will** trigger events.
 
 ### deleteAll()
 
-`method` Cake\\ORM\\Table::**deleteAll**($conditions): int
+`method` Cake\\ORM\\Table::**deleteAll**(QueryExpression|Closure|array|string|null $conditions): int
 
 There may be times when deleting rows one by one is not efficient or useful.
 In these cases it is more performant to use a bulk-delete to remove many rows at

docs/en/orm/entities.md

@@ -97,11 +97,11 @@ You can also use the `get()` and `set()` methods.
 
 ### set()
 
-`method` Cake\\ORM\\Entity::**set**($field, $value = null, array $options = [])
+`method` Cake\\ORM\\Entity::**set**(array|string $field, mixed $value = null, array $options = []): static
 
 ### get()
 
-`method` Cake\\ORM\\Entity::**get**($field)
+`method` Cake\\ORM\\Entity::**get**(string $field): mixed
 
 For example:
 
@@ -112,7 +112,7 @@ echo $article->get('title');
 
 ### patch()
 
-`method` Cake\\ORM\\Entity::**patch**(array $fields, array $options = [])
+`method` Cake\\ORM\\Entity::**patch**(array $fields, array $options = []): static
 
 Using `patch()` you can mass assign multiple fields at once:
 

docs/en/orm/saving-data.md

@@ -795,7 +795,7 @@ The `strictFields` option was added in 5.3.0.
 
 ## Saving Entities
 
-`method` Cake\\ORM\\Table::**save**(Entity $entity, array $options = []): EntityInterface|false
+`method` Cake\\ORM\\Table::**save**(EntityInterface $entity, array $options = []): EntityInterface|false
 
 When saving request data to your database you need to first hydrate a new entity
 using `newEntity()` for passing into `save()`. For example:
@@ -1285,7 +1285,7 @@ corresponding save events will be triggered.
 
 ## Find or Create an Entity
 
-`method` Cake\\ORM\\Table::**findOrCreate**($search, $callback = null, $options = []): EntityInterface
+`method` Cake\\ORM\\Table::**findOrCreate**(SelectQuery|callable|array $search, callable|array|null $callback = null, array $options = []): EntityInterface
 
 Find an existing record based on `$search` or create a new record using the
 properties in `$search` and calling the optional `$callback`. This method is
@@ -1371,7 +1371,7 @@ The result will be updated entities on success or `false` on failure.
 
 ## Bulk Updates
 
-`method` Cake\\ORM\\Table::**updateAll**($fields, $conditions): int
+`method` Cake\\ORM\\Table::**updateAll**(QueryExpression|Closure|array|string $fields, QueryExpression|Closure|array|string|null $conditions): int
 
 There may be times when updating rows individually is not efficient or
 necessary. In these cases it is more efficient to use a bulk-update to modify

docs/en/orm/table-objects.md

@@ -273,22 +273,22 @@ Behaviors, can use this hook to add in validation methods.
 
 ### buildRules
 
-`method` Cake\\ORM\\Table::**buildRules(RulesChecker $rules): RulesChecker**()
+`method` Cake\\ORM\\Table::**buildRules**(RulesChecker $rules): RulesChecker
 
 The `Model.buildRules` event is fired after a rules instance has been
 created and after the `Table::buildRules()` method has been called.
 
 ### beforeRules
 
-`method` Cake\\ORM\\Table::**beforeRules**(EventInterface $event, EntityInterface $entity, ArrayObject $options, $operation): void
+`method` Cake\\ORM\\Table::**beforeRules**(EventInterface $event, EntityInterface $entity, ArrayObject $options, string $operation): void
 
 The `Model.beforeRules` event is fired before an entity has had rules applied. By
 stopping this event, you can halt the rules checking and set the result
 of applying rules.
 
 ### afterRules
 
-`method` Cake\\ORM\\Table::**afterRules**(EventInterface $event, EntityInterface $entity, ArrayObject $options, $result, $operation): void
+`method` Cake\\ORM\\Table::**afterRules**(EventInterface $event, EntityInterface $entity, ArrayObject $options, bool $result, string $operation): void
 
 The `Model.afterRules` event is fired after an entity has rules applied. By
 stopping this event, you can return the final value of the rules checking
@@ -499,7 +499,7 @@ few other useful features as well.
 
 ### Configuring Table Objects
 
-`method` Cake\\ORM\\TableLocator::**get**($alias, $config)
+`method` Cake\\ORM\\TableLocator::**get**(string $alias, array $options = []): Table
 
 When loading tables from the registry you can customize their dependencies, or
 use mock objects by providing an `$options` array:

docs/en/views/helpers.md

@@ -377,24 +377,24 @@ does not implement any of the callback methods.
 
 #### beforeRenderFile()
 
-`method` Helper::**beforeRenderFile**(EventInterface $event, $viewFile): void
+`method` Helper::**beforeRenderFile**(EventInterface $event, string $viewFile): void
 
 #### afterRenderFile()
 
-`method` Helper::**afterRenderFile**(EventInterface $event, $viewFile, $content): void
+`method` Helper::**afterRenderFile**(EventInterface $event, string $viewFile, string $content): void
 
 #### beforeRender()
 
-`method` Helper::**beforeRender**(EventInterface $event, $viewFile): void
+`method` Helper::**beforeRender**(EventInterface $event, string $viewFile): void
 
 #### afterRender()
 
-`method` Helper::**afterRender**(EventInterface $event, $viewFile): void
+`method` Helper::**afterRender**(EventInterface $event, string $viewFile): void
 
 #### beforeLayout()
 
-`method` Helper::**beforeLayout**(EventInterface $event, $layoutFile): void
+`method` Helper::**beforeLayout**(EventInterface $event, string $layoutFile): void
 
 #### afterLayout()
 
-`method` Helper::**afterLayout**(EventInterface $event, $layoutFile): void
+`method` Helper::**afterLayout**(EventInterface $event, string $layoutFile): void